]>
Commit | Line | Data |
---|---|---|
d318976c | 1 | /* GDB CLI command scripting. |
8926118c | 2 | |
618f726f | 3 | Copyright (C) 1986-2016 Free Software Foundation, Inc. |
d318976c FN |
4 | |
5 | This file is part of GDB. | |
6 | ||
7 | This program is free software; you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
d318976c FN |
10 | (at your option) any later version. |
11 | ||
12 | This program is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
d318976c FN |
19 | |
20 | #include "defs.h" | |
21 | #include "value.h" | |
22 | #include "language.h" /* For value_true */ | |
23 | #include <ctype.h> | |
24 | ||
d318976c | 25 | #include "ui-out.h" |
d318976c | 26 | #include "top.h" |
40c03ae8 | 27 | #include "breakpoint.h" |
d318976c FN |
28 | #include "cli/cli-cmds.h" |
29 | #include "cli/cli-decode.h" | |
30 | #include "cli/cli-script.h" | |
31 | ||
6dddc817 | 32 | #include "extension.h" |
b4a14fd0 | 33 | #include "interps.h" |
bb2ec1b3 | 34 | #include "compile/compile.h" |
d57a3c85 | 35 | |
df3ee9ca PA |
36 | #include <vector> |
37 | ||
ebcd3b23 | 38 | /* Prototypes for local functions. */ |
d318976c | 39 | |
d318976c | 40 | static enum command_control_type |
a58d7472 | 41 | recurse_read_control_structure (char * (*read_next_line_func) (void), |
a7bdde9e VP |
42 | struct command_line *current_cmd, |
43 | void (*validator)(char *, void *), | |
44 | void *closure); | |
d318976c | 45 | |
a58d7472 | 46 | static char *read_next_line (void); |
3c1179ff | 47 | |
16026cd7 | 48 | /* Level of control structure when reading. */ |
d318976c FN |
49 | static int control_level; |
50 | ||
16026cd7 AS |
51 | /* Level of control structure when executing. */ |
52 | static int command_nest_depth = 1; | |
53 | ||
54 | /* This is to prevent certain commands being printed twice. */ | |
55 | static int suppress_next_print_command_trace = 0; | |
56 | ||
df3ee9ca PA |
57 | /* A non-owning slice of a string. */ |
58 | ||
59 | struct string_view | |
60 | { | |
61 | string_view (const char *str_, size_t len_) | |
62 | : str (str_), len (len_) | |
63 | {} | |
64 | ||
65 | const char *str; | |
66 | size_t len; | |
67 | }; | |
68 | ||
d318976c | 69 | /* Structure for arguments to user defined functions. */ |
df3ee9ca PA |
70 | |
71 | class user_args | |
72 | { | |
73 | public: | |
74 | /* Save the command line and store the locations of arguments passed | |
75 | to the user defined function. */ | |
76 | explicit user_args (const char *line); | |
77 | ||
78 | /* Insert the stored user defined arguments into the $arg arguments | |
79 | found in LINE. */ | |
80 | std::string insert_args (const char *line) const; | |
81 | ||
82 | private: | |
83 | /* Disable copy/assignment. (Since the elements of A point inside | |
84 | COMMAND, copying would need to reconstruct the A vector in the | |
85 | new copy.) */ | |
86 | user_args (const user_args &) =delete; | |
87 | user_args &operator= (const user_args &) =delete; | |
88 | ||
89 | /* It is necessary to store a copy of the command line to ensure | |
90 | that the arguments are not overwritten before they are used. */ | |
91 | std::string m_command_line; | |
92 | ||
93 | /* The arguments. Each element points inside M_COMMAND_LINE. */ | |
94 | std::vector<string_view> m_args; | |
95 | }; | |
96 | ||
97 | /* The stack of arguments passed to user defined functions. We need a | |
98 | stack because user-defined functions can call other user-defined | |
99 | functions. */ | |
100 | static std::vector<std::unique_ptr<user_args>> user_args_stack; | |
101 | ||
102 | /* An RAII-base class used to push/pop args on the user args | |
103 | stack. */ | |
104 | struct scoped_user_args_level | |
105 | { | |
106 | /* Parse the command line and push the arguments in the user args | |
107 | stack. */ | |
108 | explicit scoped_user_args_level (const char *line) | |
d318976c | 109 | { |
df3ee9ca | 110 | user_args_stack.emplace_back (new user_args (line)); |
d318976c | 111 | } |
df3ee9ca PA |
112 | |
113 | /* Pop the current user arguments from the stack. */ | |
114 | ~scoped_user_args_level () | |
115 | { | |
116 | user_args_stack.pop_back (); | |
117 | } | |
118 | }; | |
d318976c FN |
119 | |
120 | \f | |
1e9c71b8 DE |
121 | /* Return non-zero if TYPE is a multi-line command (i.e., is terminated |
122 | by "end"). */ | |
123 | ||
124 | static int | |
125 | multi_line_command_p (enum command_control_type type) | |
126 | { | |
127 | switch (type) | |
128 | { | |
129 | case if_control: | |
130 | case while_control: | |
131 | case while_stepping_control: | |
132 | case commands_control: | |
bb2ec1b3 | 133 | case compile_control: |
1e9c71b8 | 134 | case python_control: |
ed3ef339 | 135 | case guile_control: |
1e9c71b8 DE |
136 | return 1; |
137 | default: | |
138 | return 0; | |
139 | } | |
140 | } | |
141 | ||
d318976c FN |
142 | /* Allocate, initialize a new command line structure for one of the |
143 | control commands (if/while). */ | |
144 | ||
145 | static struct command_line * | |
146 | build_command_line (enum command_control_type type, char *args) | |
147 | { | |
148 | struct command_line *cmd; | |
149 | ||
40c03ae8 | 150 | if (args == NULL && (type == if_control || type == while_control)) |
8a3fe4f8 | 151 | error (_("if/while commands require arguments.")); |
c8c12293 | 152 | gdb_assert (args != NULL); |
d318976c | 153 | |
8d749320 | 154 | cmd = XNEW (struct command_line); |
d318976c FN |
155 | cmd->next = NULL; |
156 | cmd->control_type = type; | |
157 | ||
158 | cmd->body_count = 1; | |
8d749320 | 159 | cmd->body_list = XCNEWVEC (struct command_line *, cmd->body_count); |
1b36a34b | 160 | cmd->line = xstrdup (args); |
dd3526aa | 161 | |
d318976c FN |
162 | return cmd; |
163 | } | |
164 | ||
165 | /* Build and return a new command structure for the control commands | |
166 | such as "if" and "while". */ | |
167 | ||
d57a3c85 | 168 | struct command_line * |
d318976c FN |
169 | get_command_line (enum command_control_type type, char *arg) |
170 | { | |
171 | struct command_line *cmd; | |
172 | struct cleanup *old_chain = NULL; | |
173 | ||
174 | /* Allocate and build a new command line structure. */ | |
175 | cmd = build_command_line (type, arg); | |
176 | ||
177 | old_chain = make_cleanup_free_command_lines (&cmd); | |
178 | ||
179 | /* Read in the body of this command. */ | |
a7bdde9e VP |
180 | if (recurse_read_control_structure (read_next_line, cmd, 0, 0) |
181 | == invalid_control) | |
d318976c | 182 | { |
40c03ae8 | 183 | warning (_("Error reading in canned sequence of commands.")); |
d318976c FN |
184 | do_cleanups (old_chain); |
185 | return NULL; | |
186 | } | |
187 | ||
188 | discard_cleanups (old_chain); | |
189 | return cmd; | |
190 | } | |
191 | ||
192 | /* Recursively print a command (including full control structures). */ | |
8926118c | 193 | |
d318976c FN |
194 | void |
195 | print_command_lines (struct ui_out *uiout, struct command_line *cmd, | |
196 | unsigned int depth) | |
197 | { | |
198 | struct command_line *list; | |
199 | ||
200 | list = cmd; | |
201 | while (list) | |
202 | { | |
d318976c | 203 | if (depth) |
112e8700 | 204 | uiout->spaces (2 * depth); |
d318976c FN |
205 | |
206 | /* A simple command, print it and continue. */ | |
207 | if (list->control_type == simple_control) | |
208 | { | |
112e8700 SM |
209 | uiout->field_string (NULL, list->line); |
210 | uiout->text ("\n"); | |
d318976c FN |
211 | list = list->next; |
212 | continue; | |
213 | } | |
214 | ||
215 | /* loop_continue to jump to the start of a while loop, print it | |
216 | and continue. */ | |
217 | if (list->control_type == continue_control) | |
218 | { | |
112e8700 SM |
219 | uiout->field_string (NULL, "loop_continue"); |
220 | uiout->text ("\n"); | |
d318976c FN |
221 | list = list->next; |
222 | continue; | |
223 | } | |
224 | ||
ebcd3b23 MS |
225 | /* loop_break to break out of a while loop, print it and |
226 | continue. */ | |
d318976c FN |
227 | if (list->control_type == break_control) |
228 | { | |
112e8700 SM |
229 | uiout->field_string (NULL, "loop_break"); |
230 | uiout->text ("\n"); | |
d318976c FN |
231 | list = list->next; |
232 | continue; | |
233 | } | |
234 | ||
ebcd3b23 MS |
235 | /* A while command. Recursively print its subcommands and |
236 | continue. */ | |
a7bdde9e VP |
237 | if (list->control_type == while_control |
238 | || list->control_type == while_stepping_control) | |
d318976c | 239 | { |
ebcd3b23 MS |
240 | /* For while-stepping, the line includes the 'while-stepping' |
241 | token. See comment in process_next_line for explanation. | |
242 | Here, take care not print 'while-stepping' twice. */ | |
a7bdde9e | 243 | if (list->control_type == while_control) |
112e8700 | 244 | uiout->field_fmt (NULL, "while %s", list->line); |
a7bdde9e | 245 | else |
112e8700 SM |
246 | uiout->field_string (NULL, list->line); |
247 | uiout->text ("\n"); | |
d318976c | 248 | print_command_lines (uiout, *list->body_list, depth + 1); |
d318976c | 249 | if (depth) |
112e8700 SM |
250 | uiout->spaces (2 * depth); |
251 | uiout->field_string (NULL, "end"); | |
252 | uiout->text ("\n"); | |
d318976c FN |
253 | list = list->next; |
254 | continue; | |
255 | } | |
256 | ||
ebcd3b23 MS |
257 | /* An if command. Recursively print both arms before |
258 | continueing. */ | |
d318976c FN |
259 | if (list->control_type == if_control) |
260 | { | |
112e8700 SM |
261 | uiout->field_fmt (NULL, "if %s", list->line); |
262 | uiout->text ("\n"); | |
ebcd3b23 | 263 | /* The true arm. */ |
d318976c FN |
264 | print_command_lines (uiout, list->body_list[0], depth + 1); |
265 | ||
266 | /* Show the false arm if it exists. */ | |
267 | if (list->body_count == 2) | |
268 | { | |
269 | if (depth) | |
112e8700 SM |
270 | uiout->spaces (2 * depth); |
271 | uiout->field_string (NULL, "else"); | |
272 | uiout->text ("\n"); | |
d318976c FN |
273 | print_command_lines (uiout, list->body_list[1], depth + 1); |
274 | } | |
275 | ||
d318976c | 276 | if (depth) |
112e8700 SM |
277 | uiout->spaces (2 * depth); |
278 | uiout->field_string (NULL, "end"); | |
279 | uiout->text ("\n"); | |
d318976c FN |
280 | list = list->next; |
281 | continue; | |
282 | } | |
283 | ||
ebcd3b23 MS |
284 | /* A commands command. Print the breakpoint commands and |
285 | continue. */ | |
40c03ae8 EZ |
286 | if (list->control_type == commands_control) |
287 | { | |
288 | if (*(list->line)) | |
112e8700 | 289 | uiout->field_fmt (NULL, "commands %s", list->line); |
40c03ae8 | 290 | else |
112e8700 SM |
291 | uiout->field_string (NULL, "commands"); |
292 | uiout->text ("\n"); | |
40c03ae8 EZ |
293 | print_command_lines (uiout, *list->body_list, depth + 1); |
294 | if (depth) | |
112e8700 SM |
295 | uiout->spaces (2 * depth); |
296 | uiout->field_string (NULL, "end"); | |
297 | uiout->text ("\n"); | |
40c03ae8 EZ |
298 | list = list->next; |
299 | continue; | |
300 | } | |
301 | ||
d57a3c85 TJB |
302 | if (list->control_type == python_control) |
303 | { | |
112e8700 SM |
304 | uiout->field_string (NULL, "python"); |
305 | uiout->text ("\n"); | |
d57a3c85 TJB |
306 | /* Don't indent python code at all. */ |
307 | print_command_lines (uiout, *list->body_list, 0); | |
308 | if (depth) | |
112e8700 SM |
309 | uiout->spaces (2 * depth); |
310 | uiout->field_string (NULL, "end"); | |
311 | uiout->text ("\n"); | |
d57a3c85 TJB |
312 | list = list->next; |
313 | continue; | |
314 | } | |
315 | ||
bb2ec1b3 TT |
316 | if (list->control_type == compile_control) |
317 | { | |
112e8700 SM |
318 | uiout->field_string (NULL, "compile expression"); |
319 | uiout->text ("\n"); | |
bb2ec1b3 TT |
320 | print_command_lines (uiout, *list->body_list, 0); |
321 | if (depth) | |
112e8700 SM |
322 | uiout->spaces (2 * depth); |
323 | uiout->field_string (NULL, "end"); | |
324 | uiout->text ("\n"); | |
bb2ec1b3 TT |
325 | list = list->next; |
326 | continue; | |
327 | } | |
328 | ||
ed3ef339 DE |
329 | if (list->control_type == guile_control) |
330 | { | |
112e8700 SM |
331 | uiout->field_string (NULL, "guile"); |
332 | uiout->text ("\n"); | |
ed3ef339 DE |
333 | print_command_lines (uiout, *list->body_list, depth + 1); |
334 | if (depth) | |
112e8700 SM |
335 | uiout->spaces (2 * depth); |
336 | uiout->field_string (NULL, "end"); | |
337 | uiout->text ("\n"); | |
ed3ef339 DE |
338 | list = list->next; |
339 | continue; | |
340 | } | |
341 | ||
ebcd3b23 | 342 | /* Ignore illegal command type and try next. */ |
d318976c FN |
343 | list = list->next; |
344 | } /* while (list) */ | |
345 | } | |
d318976c | 346 | |
5913bcb0 AC |
347 | /* Handle pre-post hooks. */ |
348 | ||
b9362cc7 | 349 | static void |
5913bcb0 AC |
350 | clear_hook_in_cleanup (void *data) |
351 | { | |
9a3c8263 | 352 | struct cmd_list_element *c = (struct cmd_list_element *) data; |
cdb27c12 | 353 | |
ebcd3b23 | 354 | c->hook_in = 0; /* Allow hook to work again once it is complete. */ |
5913bcb0 AC |
355 | } |
356 | ||
357 | void | |
358 | execute_cmd_pre_hook (struct cmd_list_element *c) | |
359 | { | |
360 | if ((c->hook_pre) && (!c->hook_in)) | |
361 | { | |
362 | struct cleanup *cleanups = make_cleanup (clear_hook_in_cleanup, c); | |
ebcd3b23 | 363 | c->hook_in = 1; /* Prevent recursive hooking. */ |
5913bcb0 AC |
364 | execute_user_command (c->hook_pre, (char *) 0); |
365 | do_cleanups (cleanups); | |
366 | } | |
367 | } | |
368 | ||
369 | void | |
370 | execute_cmd_post_hook (struct cmd_list_element *c) | |
371 | { | |
372 | if ((c->hook_post) && (!c->hook_in)) | |
373 | { | |
374 | struct cleanup *cleanups = make_cleanup (clear_hook_in_cleanup, c); | |
cdb27c12 | 375 | |
ebcd3b23 | 376 | c->hook_in = 1; /* Prevent recursive hooking. */ |
5913bcb0 AC |
377 | execute_user_command (c->hook_post, (char *) 0); |
378 | do_cleanups (cleanups); | |
379 | } | |
380 | } | |
381 | ||
d318976c | 382 | /* Execute the command in CMD. */ |
b9362cc7 | 383 | static void |
20f01a46 DH |
384 | do_restore_user_call_depth (void * call_depth) |
385 | { | |
9a3c8263 | 386 | int *depth = (int *) call_depth; |
cdb27c12 | 387 | |
698ba934 DJ |
388 | (*depth)--; |
389 | if ((*depth) == 0) | |
390 | in_user_command = 0; | |
20f01a46 DH |
391 | } |
392 | ||
d318976c FN |
393 | |
394 | void | |
395 | execute_user_command (struct cmd_list_element *c, char *args) | |
396 | { | |
f38d3ad1 | 397 | struct ui *ui = current_ui; |
d5b5ac79 | 398 | struct command_line *cmdlines; |
d318976c FN |
399 | struct cleanup *old_chain; |
400 | enum command_control_type ret; | |
20f01a46 | 401 | static int user_call_depth = 0; |
883b9c6c | 402 | extern unsigned int max_user_call_depth; |
d318976c | 403 | |
d318976c FN |
404 | cmdlines = c->user_commands; |
405 | if (cmdlines == 0) | |
406 | /* Null command */ | |
407 | return; | |
408 | ||
df3ee9ca | 409 | scoped_user_args_level push_user_args (args); |
5fe41fbf | 410 | |
20f01a46 | 411 | if (++user_call_depth > max_user_call_depth) |
8a3fe4f8 | 412 | error (_("Max user call depth exceeded -- command aborted.")); |
20f01a46 | 413 | |
df3ee9ca | 414 | old_chain = make_cleanup (do_restore_user_call_depth, &user_call_depth); |
20f01a46 | 415 | |
d318976c FN |
416 | /* Set the instream to 0, indicating execution of a |
417 | user-defined function. */ | |
f38d3ad1 PA |
418 | make_cleanup (do_restore_instream_cleanup, ui->instream); |
419 | ui->instream = NULL; | |
698ba934 DJ |
420 | |
421 | /* Also set the global in_user_command, so that NULL instream is | |
422 | not confused with Insight. */ | |
423 | in_user_command = 1; | |
424 | ||
b7b633e9 | 425 | scoped_restore save_async = make_scoped_restore (¤t_ui->async, 0); |
b4a14fd0 | 426 | |
8625200f | 427 | command_nest_depth++; |
d318976c FN |
428 | while (cmdlines) |
429 | { | |
430 | ret = execute_control_command (cmdlines); | |
431 | if (ret != simple_control && ret != break_control) | |
432 | { | |
40c03ae8 | 433 | warning (_("Error executing canned sequence of commands.")); |
d318976c FN |
434 | break; |
435 | } | |
436 | cmdlines = cmdlines->next; | |
437 | } | |
8625200f | 438 | command_nest_depth--; |
d318976c FN |
439 | do_cleanups (old_chain); |
440 | } | |
441 | ||
ebcd3b23 MS |
442 | /* This function is called every time GDB prints a prompt. It ensures |
443 | that errors and the like do not confuse the command tracing. */ | |
16026cd7 AS |
444 | |
445 | void | |
446 | reset_command_nest_depth (void) | |
447 | { | |
448 | command_nest_depth = 1; | |
449 | ||
450 | /* Just in case. */ | |
451 | suppress_next_print_command_trace = 0; | |
452 | } | |
453 | ||
454 | /* Print the command, prefixed with '+' to represent the call depth. | |
455 | This is slightly complicated because this function may be called | |
456 | from execute_command and execute_control_command. Unfortunately | |
457 | execute_command also prints the top level control commands. | |
458 | In these cases execute_command will call execute_control_command | |
459 | via while_command or if_command. Inner levels of 'if' and 'while' | |
460 | are dealt with directly. Therefore we can use these functions | |
461 | to determine whether the command has been printed already or not. */ | |
462 | void | |
463 | print_command_trace (const char *cmd) | |
464 | { | |
465 | int i; | |
466 | ||
467 | if (suppress_next_print_command_trace) | |
468 | { | |
469 | suppress_next_print_command_trace = 0; | |
470 | return; | |
471 | } | |
472 | ||
473 | if (!source_verbose && !trace_commands) | |
474 | return; | |
475 | ||
476 | for (i=0; i < command_nest_depth; i++) | |
477 | printf_filtered ("+"); | |
478 | ||
479 | printf_filtered ("%s\n", cmd); | |
480 | } | |
481 | ||
d318976c FN |
482 | enum command_control_type |
483 | execute_control_command (struct command_line *cmd) | |
484 | { | |
d318976c | 485 | struct command_line *current; |
f976f6d4 AC |
486 | struct value *val; |
487 | struct value *val_mark; | |
d318976c FN |
488 | int loop; |
489 | enum command_control_type ret; | |
d318976c | 490 | |
4d2acc65 AC |
491 | /* Start by assuming failure, if a problem is detected, the code |
492 | below will simply "break" out of the switch. */ | |
493 | ret = invalid_control; | |
494 | ||
d318976c FN |
495 | switch (cmd->control_type) |
496 | { | |
497 | case simple_control: | |
b0646401 PA |
498 | { |
499 | /* A simple command, execute it and return. */ | |
01770bbd | 500 | std::string new_line = insert_user_defined_cmd_args (cmd->line); |
b0646401 PA |
501 | execute_command (&new_line[0], 0); |
502 | ret = cmd->control_type; | |
503 | break; | |
504 | } | |
d318976c FN |
505 | |
506 | case continue_control: | |
16026cd7 AS |
507 | print_command_trace ("loop_continue"); |
508 | ||
509 | /* Return for "continue", and "break" so we can either | |
510 | continue the loop at the top, or break out. */ | |
511 | ret = cmd->control_type; | |
512 | break; | |
513 | ||
d318976c | 514 | case break_control: |
16026cd7 AS |
515 | print_command_trace ("loop_break"); |
516 | ||
d318976c FN |
517 | /* Return for "continue", and "break" so we can either |
518 | continue the loop at the top, or break out. */ | |
519 | ret = cmd->control_type; | |
520 | break; | |
521 | ||
522 | case while_control: | |
523 | { | |
8c042590 | 524 | int len = strlen (cmd->line) + 7; |
224c3ddb | 525 | char *buffer = (char *) alloca (len); |
cdb27c12 | 526 | |
8c042590 | 527 | xsnprintf (buffer, len, "while %s", cmd->line); |
16026cd7 AS |
528 | print_command_trace (buffer); |
529 | ||
d318976c | 530 | /* Parse the loop control expression for the while statement. */ |
01770bbd | 531 | std::string new_line = insert_user_defined_cmd_args (cmd->line); |
4d01a485 | 532 | expression_up expr = parse_expression (new_line.c_str ()); |
d318976c FN |
533 | |
534 | ret = simple_control; | |
535 | loop = 1; | |
536 | ||
537 | /* Keep iterating so long as the expression is true. */ | |
538 | while (loop == 1) | |
539 | { | |
540 | int cond_result; | |
541 | ||
542 | QUIT; | |
543 | ||
544 | /* Evaluate the expression. */ | |
545 | val_mark = value_mark (); | |
4d01a485 | 546 | val = evaluate_expression (expr.get ()); |
d318976c FN |
547 | cond_result = value_true (val); |
548 | value_free_to_mark (val_mark); | |
549 | ||
550 | /* If the value is false, then break out of the loop. */ | |
551 | if (!cond_result) | |
552 | break; | |
553 | ||
554 | /* Execute the body of the while statement. */ | |
555 | current = *cmd->body_list; | |
556 | while (current) | |
557 | { | |
16026cd7 | 558 | command_nest_depth++; |
d318976c | 559 | ret = execute_control_command (current); |
16026cd7 | 560 | command_nest_depth--; |
d318976c FN |
561 | |
562 | /* If we got an error, or a "break" command, then stop | |
563 | looping. */ | |
564 | if (ret == invalid_control || ret == break_control) | |
565 | { | |
566 | loop = 0; | |
567 | break; | |
568 | } | |
569 | ||
570 | /* If we got a "continue" command, then restart the loop | |
571 | at this point. */ | |
572 | if (ret == continue_control) | |
573 | break; | |
574 | ||
575 | /* Get the next statement. */ | |
576 | current = current->next; | |
577 | } | |
578 | } | |
579 | ||
580 | /* Reset RET so that we don't recurse the break all the way down. */ | |
581 | if (ret == break_control) | |
582 | ret = simple_control; | |
583 | ||
584 | break; | |
585 | } | |
586 | ||
587 | case if_control: | |
588 | { | |
8c042590 | 589 | int len = strlen (cmd->line) + 4; |
224c3ddb | 590 | char *buffer = (char *) alloca (len); |
cdb27c12 | 591 | |
8c042590 | 592 | xsnprintf (buffer, len, "if %s", cmd->line); |
16026cd7 AS |
593 | print_command_trace (buffer); |
594 | ||
d318976c | 595 | /* Parse the conditional for the if statement. */ |
01770bbd | 596 | std::string new_line = insert_user_defined_cmd_args (cmd->line); |
4d01a485 | 597 | expression_up expr = parse_expression (new_line.c_str ()); |
d318976c FN |
598 | |
599 | current = NULL; | |
600 | ret = simple_control; | |
601 | ||
602 | /* Evaluate the conditional. */ | |
603 | val_mark = value_mark (); | |
4d01a485 | 604 | val = evaluate_expression (expr.get ()); |
d318976c | 605 | |
ebcd3b23 MS |
606 | /* Choose which arm to take commands from based on the value |
607 | of the conditional expression. */ | |
d318976c FN |
608 | if (value_true (val)) |
609 | current = *cmd->body_list; | |
610 | else if (cmd->body_count == 2) | |
611 | current = *(cmd->body_list + 1); | |
612 | value_free_to_mark (val_mark); | |
613 | ||
614 | /* Execute commands in the given arm. */ | |
615 | while (current) | |
616 | { | |
16026cd7 | 617 | command_nest_depth++; |
d318976c | 618 | ret = execute_control_command (current); |
16026cd7 | 619 | command_nest_depth--; |
d318976c FN |
620 | |
621 | /* If we got an error, get out. */ | |
622 | if (ret != simple_control) | |
623 | break; | |
624 | ||
625 | /* Get the next statement in the body. */ | |
626 | current = current->next; | |
627 | } | |
628 | ||
629 | break; | |
630 | } | |
1e9c71b8 | 631 | |
40c03ae8 EZ |
632 | case commands_control: |
633 | { | |
ebcd3b23 MS |
634 | /* Breakpoint commands list, record the commands in the |
635 | breakpoint's command list and return. */ | |
01770bbd | 636 | std::string new_line = insert_user_defined_cmd_args (cmd->line); |
b0646401 | 637 | ret = commands_from_control_command (new_line.c_str (), cmd); |
40c03ae8 EZ |
638 | break; |
639 | } | |
1e9c71b8 | 640 | |
bb2ec1b3 | 641 | case compile_control: |
5c65b58a JK |
642 | eval_compile_command (cmd, NULL, cmd->control_u.compile.scope, |
643 | cmd->control_u.compile.scope_data); | |
bb2ec1b3 TT |
644 | ret = simple_control; |
645 | break; | |
646 | ||
d57a3c85 | 647 | case python_control: |
ed3ef339 | 648 | case guile_control: |
d57a3c85 | 649 | { |
6dddc817 | 650 | eval_ext_lang_from_control_command (cmd); |
d57a3c85 TJB |
651 | ret = simple_control; |
652 | break; | |
653 | } | |
d318976c FN |
654 | |
655 | default: | |
40c03ae8 | 656 | warning (_("Invalid control type in canned commands structure.")); |
4d2acc65 | 657 | break; |
d318976c FN |
658 | } |
659 | ||
d318976c FN |
660 | return ret; |
661 | } | |
662 | ||
d57a3c85 | 663 | /* Like execute_control_command, but first set |
ebcd3b23 | 664 | suppress_next_print_command_trace. */ |
d57a3c85 TJB |
665 | |
666 | enum command_control_type | |
667 | execute_control_command_untraced (struct command_line *cmd) | |
668 | { | |
669 | suppress_next_print_command_trace = 1; | |
670 | return execute_control_command (cmd); | |
671 | } | |
672 | ||
673 | ||
d318976c FN |
674 | /* "while" command support. Executes a body of statements while the |
675 | loop condition is nonzero. */ | |
676 | ||
2370e853 | 677 | static void |
d318976c FN |
678 | while_command (char *arg, int from_tty) |
679 | { | |
680 | struct command_line *command = NULL; | |
681 | ||
682 | control_level = 1; | |
683 | command = get_command_line (while_control, arg); | |
684 | ||
685 | if (command == NULL) | |
686 | return; | |
687 | ||
b7b633e9 | 688 | scoped_restore save_async = make_scoped_restore (¤t_ui->async, 0); |
b4a14fd0 | 689 | |
d57a3c85 | 690 | execute_control_command_untraced (command); |
d318976c FN |
691 | free_command_lines (&command); |
692 | } | |
693 | ||
694 | /* "if" command support. Execute either the true or false arm depending | |
695 | on the value of the if conditional. */ | |
696 | ||
2370e853 | 697 | static void |
d318976c FN |
698 | if_command (char *arg, int from_tty) |
699 | { | |
700 | struct command_line *command = NULL; | |
b4a14fd0 | 701 | struct cleanup *old_chain; |
d318976c FN |
702 | |
703 | control_level = 1; | |
704 | command = get_command_line (if_control, arg); | |
705 | ||
706 | if (command == NULL) | |
707 | return; | |
708 | ||
b7b633e9 | 709 | scoped_restore save_async = make_scoped_restore (¤t_ui->async, 0); |
b4a14fd0 | 710 | |
d57a3c85 | 711 | execute_control_command_untraced (command); |
d318976c FN |
712 | free_command_lines (&command); |
713 | } | |
714 | ||
df3ee9ca PA |
715 | /* Bind the incoming arguments for a user defined command to $arg0, |
716 | $arg1 ... $argN. */ | |
d318976c | 717 | |
df3ee9ca | 718 | user_args::user_args (const char *command_line) |
d318976c | 719 | { |
df3ee9ca | 720 | const char *p; |
d318976c | 721 | |
df3ee9ca PA |
722 | if (command_line == NULL) |
723 | return; | |
d318976c | 724 | |
df3ee9ca PA |
725 | m_command_line = command_line; |
726 | p = m_command_line.c_str (); | |
e28493f2 | 727 | |
d318976c FN |
728 | while (*p) |
729 | { | |
df3ee9ca | 730 | const char *start_arg; |
d318976c FN |
731 | int squote = 0; |
732 | int dquote = 0; | |
733 | int bsquote = 0; | |
734 | ||
d318976c FN |
735 | /* Strip whitespace. */ |
736 | while (*p == ' ' || *p == '\t') | |
737 | p++; | |
738 | ||
739 | /* P now points to an argument. */ | |
740 | start_arg = p; | |
d318976c FN |
741 | |
742 | /* Get to the end of this argument. */ | |
743 | while (*p) | |
744 | { | |
745 | if (((*p == ' ' || *p == '\t')) && !squote && !dquote && !bsquote) | |
746 | break; | |
747 | else | |
748 | { | |
749 | if (bsquote) | |
750 | bsquote = 0; | |
751 | else if (*p == '\\') | |
752 | bsquote = 1; | |
753 | else if (squote) | |
754 | { | |
755 | if (*p == '\'') | |
756 | squote = 0; | |
757 | } | |
758 | else if (dquote) | |
759 | { | |
760 | if (*p == '"') | |
761 | dquote = 0; | |
762 | } | |
763 | else | |
764 | { | |
765 | if (*p == '\'') | |
766 | squote = 1; | |
767 | else if (*p == '"') | |
768 | dquote = 1; | |
769 | } | |
770 | p++; | |
771 | } | |
772 | } | |
773 | ||
df3ee9ca | 774 | m_args.emplace_back (start_arg, p - start_arg); |
d318976c | 775 | } |
d318976c FN |
776 | } |
777 | ||
ebcd3b23 MS |
778 | /* Given character string P, return a point to the first argument |
779 | ($arg), or NULL if P contains no arguments. */ | |
d318976c | 780 | |
b0646401 PA |
781 | static const char * |
782 | locate_arg (const char *p) | |
d318976c FN |
783 | { |
784 | while ((p = strchr (p, '$'))) | |
785 | { | |
61012eef | 786 | if (startswith (p, "$arg") |
c03c782f | 787 | && (isdigit (p[4]) || p[4] == 'c')) |
d318976c FN |
788 | return p; |
789 | p++; | |
790 | } | |
791 | return NULL; | |
792 | } | |
793 | ||
01770bbd | 794 | /* See cli-script.h. */ |
d318976c | 795 | |
01770bbd PA |
796 | std::string |
797 | insert_user_defined_cmd_args (const char *line) | |
d318976c | 798 | { |
01770bbd | 799 | /* If we are not in a user-defined command, treat $argc, $arg0, et |
61d9b92f | 800 | cetera as normal convenience variables. */ |
df3ee9ca | 801 | if (user_args_stack.empty ()) |
b0646401 | 802 | return line; |
61d9b92f | 803 | |
df3ee9ca PA |
804 | const std::unique_ptr<user_args> &args = user_args_stack.back (); |
805 | return args->insert_args (line); | |
806 | } | |
807 | ||
808 | /* Insert the user defined arguments stored in user_args into the $arg | |
809 | arguments found in line. */ | |
810 | ||
811 | std::string | |
812 | user_args::insert_args (const char *line) const | |
813 | { | |
b0646401 PA |
814 | std::string new_line; |
815 | const char *p; | |
d318976c FN |
816 | |
817 | while ((p = locate_arg (line))) | |
818 | { | |
b0646401 | 819 | new_line.append (line, p - line); |
d318976c | 820 | |
c03c782f AS |
821 | if (p[4] == 'c') |
822 | { | |
df3ee9ca PA |
823 | new_line += std::to_string (m_args.size ()); |
824 | line = p + 5; | |
c03c782f AS |
825 | } |
826 | else | |
d318976c | 827 | { |
df3ee9ca PA |
828 | char *tmp; |
829 | unsigned long i; | |
830 | ||
831 | errno = 0; | |
832 | i = strtoul (p + 4, &tmp, 10); | |
833 | if ((i == 0 && tmp == p + 4) || errno != 0) | |
834 | line = p + 4; | |
835 | else if (i >= m_args.size ()) | |
836 | error (_("Missing argument %ld in user function."), i); | |
837 | else | |
838 | { | |
839 | new_line.append (m_args[i].str, m_args[i].len); | |
840 | line = tmp; | |
841 | } | |
d318976c | 842 | } |
d318976c FN |
843 | } |
844 | /* Don't forget the tail. */ | |
b0646401 | 845 | new_line.append (line); |
d318976c | 846 | |
b0646401 | 847 | return new_line; |
d318976c FN |
848 | } |
849 | ||
850 | \f | |
851 | /* Expand the body_list of COMMAND so that it can hold NEW_LENGTH | |
852 | code bodies. This is typically used when we encounter an "else" | |
853 | clause for an "if" command. */ | |
854 | ||
855 | static void | |
856 | realloc_body_list (struct command_line *command, int new_length) | |
857 | { | |
858 | int n; | |
859 | struct command_line **body_list; | |
860 | ||
861 | n = command->body_count; | |
862 | ||
863 | /* Nothing to do? */ | |
864 | if (new_length <= n) | |
865 | return; | |
866 | ||
8d749320 | 867 | body_list = XCNEWVEC (struct command_line *, new_length); |
d318976c FN |
868 | |
869 | memcpy (body_list, command->body_list, sizeof (struct command_line *) * n); | |
870 | ||
b8c9b27d | 871 | xfree (command->body_list); |
d318976c FN |
872 | command->body_list = body_list; |
873 | command->body_count = new_length; | |
874 | } | |
875 | ||
2181a6c6 | 876 | /* Read next line from stdin. Passed to read_command_line_1 and |
3c1179ff | 877 | recurse_read_control_structure whenever we need to read commands |
2181a6c6 | 878 | from stdin. */ |
d318976c | 879 | |
3c1179ff | 880 | static char * |
a58d7472 | 881 | read_next_line (void) |
d318976c | 882 | { |
f38d3ad1 | 883 | struct ui *ui = current_ui; |
3c1179ff | 884 | char *prompt_ptr, control_prompt[256]; |
d318976c | 885 | int i = 0; |
268a799a | 886 | int from_tty = ui->instream == ui->stdin_stream; |
d318976c FN |
887 | |
888 | if (control_level >= 254) | |
8a3fe4f8 | 889 | error (_("Control nesting too deep!")); |
d318976c FN |
890 | |
891 | /* Set a prompt based on the nesting of the control commands. */ | |
268a799a | 892 | if (from_tty |
f38d3ad1 | 893 | || (ui->instream == 0 && deprecated_readline_hook != NULL)) |
d318976c FN |
894 | { |
895 | for (i = 0; i < control_level; i++) | |
896 | control_prompt[i] = ' '; | |
897 | control_prompt[i] = '>'; | |
898 | control_prompt[i + 1] = '\0'; | |
899 | prompt_ptr = (char *) &control_prompt[0]; | |
900 | } | |
901 | else | |
902 | prompt_ptr = NULL; | |
903 | ||
268a799a | 904 | return command_line_input (prompt_ptr, from_tty, "commands"); |
3c1179ff VP |
905 | } |
906 | ||
ebcd3b23 MS |
907 | /* Process one input line. If the command is an "end", return such an |
908 | indication to the caller. If PARSE_COMMANDS is true, strip leading | |
909 | whitespace (trailing whitespace is always stripped) in the line, | |
910 | attempt to recognize GDB control commands, and also return an | |
911 | indication if the command is an "else" or a nop. | |
912 | ||
3c1179ff VP |
913 | Otherwise, only "end" is recognized. */ |
914 | ||
915 | static enum misc_command_type | |
a7bdde9e VP |
916 | process_next_line (char *p, struct command_line **command, int parse_commands, |
917 | void (*validator)(char *, void *), void *closure) | |
3c1179ff | 918 | { |
50cb2941 JK |
919 | char *p_end; |
920 | char *p_start; | |
3c1179ff | 921 | int not_handled = 0; |
d318976c FN |
922 | |
923 | /* Not sure what to do here. */ | |
924 | if (p == NULL) | |
925 | return end_command; | |
926 | ||
311a4e6b | 927 | /* Strip trailing whitespace. */ |
50cb2941 JK |
928 | p_end = p + strlen (p); |
929 | while (p_end > p && (p_end[-1] == ' ' || p_end[-1] == '\t')) | |
930 | p_end--; | |
d318976c | 931 | |
50cb2941 | 932 | p_start = p; |
3630a92d | 933 | /* Strip leading whitespace. */ |
50cb2941 JK |
934 | while (p_start < p_end && (*p_start == ' ' || *p_start == '\t')) |
935 | p_start++; | |
d318976c | 936 | |
ebcd3b23 | 937 | /* 'end' is always recognized, regardless of parse_commands value. |
3630a92d | 938 | We also permit whitespace before end and after. */ |
61012eef | 939 | if (p_end - p_start == 3 && startswith (p_start, "end")) |
3630a92d VP |
940 | return end_command; |
941 | ||
311a4e6b | 942 | if (parse_commands) |
d318976c | 943 | { |
ebcd3b23 | 944 | /* If commands are parsed, we skip initial spaces. Otherwise, |
3630a92d VP |
945 | which is the case for Python commands and documentation |
946 | (see the 'document' command), spaces are preserved. */ | |
50cb2941 | 947 | p = p_start; |
3630a92d | 948 | |
311a4e6b | 949 | /* Blanks and comments don't really do anything, but we need to |
ebcd3b23 MS |
950 | distinguish them from else, end and other commands which can |
951 | be executed. */ | |
50cb2941 | 952 | if (p_end == p || p[0] == '#') |
311a4e6b TJB |
953 | return nop_command; |
954 | ||
955 | /* Is the else clause of an if control structure? */ | |
61012eef | 956 | if (p_end - p == 4 && startswith (p, "else")) |
311a4e6b TJB |
957 | return else_command; |
958 | ||
ebcd3b23 MS |
959 | /* Check for while, if, break, continue, etc and build a new |
960 | command line structure for them. */ | |
61012eef GB |
961 | if ((p_end - p >= 14 && startswith (p, "while-stepping")) |
962 | || (p_end - p >= 8 && startswith (p, "stepping")) | |
963 | || (p_end - p >= 2 && startswith (p, "ws"))) | |
a7bdde9e VP |
964 | { |
965 | /* Because validate_actionline and encode_action lookup | |
966 | command's line as command, we need the line to | |
967 | include 'while-stepping'. | |
968 | ||
969 | For 'ws' alias, the command will have 'ws', not expanded | |
ebcd3b23 | 970 | to 'while-stepping'. This is intentional -- we don't |
a7bdde9e | 971 | really want frontend to send a command list with 'ws', |
ebcd3b23 MS |
972 | and next break-info returning command line with |
973 | 'while-stepping'. This should work, but might cause the | |
974 | breakpoint to be marked as changed while it's actually | |
975 | not. */ | |
a7bdde9e VP |
976 | *command = build_command_line (while_stepping_control, p); |
977 | } | |
61012eef | 978 | else if (p_end - p > 5 && startswith (p, "while")) |
311a4e6b TJB |
979 | { |
980 | char *first_arg; | |
cdb27c12 | 981 | |
311a4e6b | 982 | first_arg = p + 5; |
50cb2941 | 983 | while (first_arg < p_end && isspace (*first_arg)) |
311a4e6b TJB |
984 | first_arg++; |
985 | *command = build_command_line (while_control, first_arg); | |
986 | } | |
61012eef | 987 | else if (p_end - p > 2 && startswith (p, "if")) |
311a4e6b TJB |
988 | { |
989 | char *first_arg; | |
cdb27c12 | 990 | |
311a4e6b | 991 | first_arg = p + 2; |
50cb2941 | 992 | while (first_arg < p_end && isspace (*first_arg)) |
311a4e6b TJB |
993 | first_arg++; |
994 | *command = build_command_line (if_control, first_arg); | |
995 | } | |
61012eef | 996 | else if (p_end - p >= 8 && startswith (p, "commands")) |
311a4e6b TJB |
997 | { |
998 | char *first_arg; | |
cdb27c12 | 999 | |
311a4e6b | 1000 | first_arg = p + 8; |
50cb2941 | 1001 | while (first_arg < p_end && isspace (*first_arg)) |
311a4e6b TJB |
1002 | first_arg++; |
1003 | *command = build_command_line (commands_control, first_arg); | |
1004 | } | |
61012eef | 1005 | else if (p_end - p == 6 && startswith (p, "python")) |
311a4e6b TJB |
1006 | { |
1007 | /* Note that we ignore the inline "python command" form | |
1008 | here. */ | |
1009 | *command = build_command_line (python_control, ""); | |
1010 | } | |
61012eef | 1011 | else if (p_end - p == 6 && startswith (p, "compile")) |
bb2ec1b3 TT |
1012 | { |
1013 | /* Note that we ignore the inline "compile command" form | |
1014 | here. */ | |
1015 | *command = build_command_line (compile_control, ""); | |
1016 | (*command)->control_u.compile.scope = COMPILE_I_INVALID_SCOPE; | |
1017 | } | |
1018 | ||
61012eef | 1019 | else if (p_end - p == 5 && startswith (p, "guile")) |
ed3ef339 DE |
1020 | { |
1021 | /* Note that we ignore the inline "guile command" form here. */ | |
1022 | *command = build_command_line (guile_control, ""); | |
1023 | } | |
61012eef | 1024 | else if (p_end - p == 10 && startswith (p, "loop_break")) |
311a4e6b | 1025 | { |
8d749320 | 1026 | *command = XNEW (struct command_line); |
311a4e6b TJB |
1027 | (*command)->next = NULL; |
1028 | (*command)->line = NULL; | |
1029 | (*command)->control_type = break_control; | |
1030 | (*command)->body_count = 0; | |
1031 | (*command)->body_list = NULL; | |
1032 | } | |
61012eef | 1033 | else if (p_end - p == 13 && startswith (p, "loop_continue")) |
311a4e6b | 1034 | { |
8d749320 | 1035 | *command = XNEW (struct command_line); |
311a4e6b TJB |
1036 | (*command)->next = NULL; |
1037 | (*command)->line = NULL; | |
1038 | (*command)->control_type = continue_control; | |
1039 | (*command)->body_count = 0; | |
1040 | (*command)->body_list = NULL; | |
1041 | } | |
1042 | else | |
1043 | not_handled = 1; | |
d318976c | 1044 | } |
311a4e6b TJB |
1045 | |
1046 | if (!parse_commands || not_handled) | |
d318976c FN |
1047 | { |
1048 | /* A normal command. */ | |
8d749320 | 1049 | *command = XNEW (struct command_line); |
d318976c | 1050 | (*command)->next = NULL; |
50cb2941 | 1051 | (*command)->line = savestring (p, p_end - p); |
d318976c FN |
1052 | (*command)->control_type = simple_control; |
1053 | (*command)->body_count = 0; | |
1054 | (*command)->body_list = NULL; | |
1055 | } | |
1056 | ||
a7bdde9e VP |
1057 | if (validator) |
1058 | { | |
cdb27c12 | 1059 | |
492d29ea | 1060 | TRY |
a7bdde9e VP |
1061 | { |
1062 | validator ((*command)->line, closure); | |
1063 | } | |
492d29ea | 1064 | CATCH (ex, RETURN_MASK_ALL) |
a7bdde9e VP |
1065 | { |
1066 | xfree (*command); | |
1067 | throw_exception (ex); | |
1068 | } | |
492d29ea | 1069 | END_CATCH |
a7bdde9e VP |
1070 | } |
1071 | ||
d318976c FN |
1072 | /* Nothing special. */ |
1073 | return ok_command; | |
1074 | } | |
1075 | ||
ebcd3b23 MS |
1076 | /* Recursively read in the control structures and create a |
1077 | command_line structure from them. Use read_next_line_func to | |
1078 | obtain lines of the command. */ | |
d318976c FN |
1079 | |
1080 | static enum command_control_type | |
a58d7472 | 1081 | recurse_read_control_structure (char * (*read_next_line_func) (void), |
a7bdde9e VP |
1082 | struct command_line *current_cmd, |
1083 | void (*validator)(char *, void *), | |
1084 | void *closure) | |
d318976c FN |
1085 | { |
1086 | int current_body, i; | |
1087 | enum misc_command_type val; | |
1088 | enum command_control_type ret; | |
1089 | struct command_line **body_ptr, *child_tail, *next; | |
1090 | ||
1091 | child_tail = NULL; | |
1092 | current_body = 1; | |
1093 | ||
1094 | /* Sanity checks. */ | |
1095 | if (current_cmd->control_type == simple_control) | |
8a3fe4f8 | 1096 | error (_("Recursed on a simple control type.")); |
d318976c FN |
1097 | |
1098 | if (current_body > current_cmd->body_count) | |
8a3fe4f8 | 1099 | error (_("Allocated body is smaller than this command type needs.")); |
d318976c FN |
1100 | |
1101 | /* Read lines from the input stream and build control structures. */ | |
1102 | while (1) | |
1103 | { | |
1104 | dont_repeat (); | |
1105 | ||
1106 | next = NULL; | |
3c1179ff | 1107 | val = process_next_line (read_next_line_func (), &next, |
ed3ef339 | 1108 | current_cmd->control_type != python_control |
bb2ec1b3 TT |
1109 | && current_cmd->control_type != guile_control |
1110 | && current_cmd->control_type != compile_control, | |
a7bdde9e | 1111 | validator, closure); |
d318976c FN |
1112 | |
1113 | /* Just skip blanks and comments. */ | |
1114 | if (val == nop_command) | |
1115 | continue; | |
1116 | ||
1117 | if (val == end_command) | |
1118 | { | |
1e9c71b8 | 1119 | if (multi_line_command_p (current_cmd->control_type)) |
d318976c | 1120 | { |
40c03ae8 | 1121 | /* Success reading an entire canned sequence of commands. */ |
d318976c FN |
1122 | ret = simple_control; |
1123 | break; | |
1124 | } | |
1125 | else | |
1126 | { | |
1127 | ret = invalid_control; | |
1128 | break; | |
1129 | } | |
1130 | } | |
1131 | ||
1132 | /* Not the end of a control structure. */ | |
1133 | if (val == else_command) | |
1134 | { | |
1135 | if (current_cmd->control_type == if_control | |
1136 | && current_body == 1) | |
1137 | { | |
1138 | realloc_body_list (current_cmd, 2); | |
1139 | current_body = 2; | |
1140 | child_tail = NULL; | |
1141 | continue; | |
1142 | } | |
1143 | else | |
1144 | { | |
1145 | ret = invalid_control; | |
1146 | break; | |
1147 | } | |
1148 | } | |
1149 | ||
1150 | if (child_tail) | |
1151 | { | |
1152 | child_tail->next = next; | |
1153 | } | |
1154 | else | |
1155 | { | |
1156 | body_ptr = current_cmd->body_list; | |
1157 | for (i = 1; i < current_body; i++) | |
1158 | body_ptr++; | |
1159 | ||
1160 | *body_ptr = next; | |
1161 | ||
1162 | } | |
1163 | ||
1164 | child_tail = next; | |
1165 | ||
1166 | /* If the latest line is another control structure, then recurse | |
1167 | on it. */ | |
1e9c71b8 | 1168 | if (multi_line_command_p (next->control_type)) |
d318976c FN |
1169 | { |
1170 | control_level++; | |
a7bdde9e VP |
1171 | ret = recurse_read_control_structure (read_next_line_func, next, |
1172 | validator, closure); | |
d318976c FN |
1173 | control_level--; |
1174 | ||
1175 | if (ret != simple_control) | |
1176 | break; | |
1177 | } | |
1178 | } | |
1179 | ||
1180 | dont_repeat (); | |
1181 | ||
1182 | return ret; | |
1183 | } | |
1184 | ||
c41535fd EZ |
1185 | static void |
1186 | restore_interp (void *arg) | |
1187 | { | |
1188 | interp_set_temp (interp_name ((struct interp *)arg)); | |
1189 | } | |
1190 | ||
d318976c FN |
1191 | /* Read lines from the input stream and accumulate them in a chain of |
1192 | struct command_line's, which is then returned. For input from a | |
1193 | terminal, the special command "end" is used to mark the end of the | |
311a4e6b TJB |
1194 | input, and is not included in the returned chain of commands. |
1195 | ||
1196 | If PARSE_COMMANDS is true, strip leading whitespace (trailing whitespace | |
1197 | is always stripped) in the line and attempt to recognize GDB control | |
1198 | commands. Otherwise, only "end" is recognized. */ | |
d318976c FN |
1199 | |
1200 | #define END_MESSAGE "End with a line saying just \"end\"." | |
1201 | ||
1202 | struct command_line * | |
a7bdde9e VP |
1203 | read_command_lines (char *prompt_arg, int from_tty, int parse_commands, |
1204 | void (*validator)(char *, void *), void *closure) | |
d318976c | 1205 | { |
3c1179ff | 1206 | struct command_line *head; |
698ba934 | 1207 | |
268a799a | 1208 | if (from_tty && input_interactive_p (current_ui)) |
d318976c | 1209 | { |
698ba934 DJ |
1210 | if (deprecated_readline_begin_hook) |
1211 | { | |
ebcd3b23 | 1212 | /* Note - intentional to merge messages with no newline. */ |
9a2b4c1b MS |
1213 | (*deprecated_readline_begin_hook) ("%s %s\n", prompt_arg, |
1214 | END_MESSAGE); | |
698ba934 DJ |
1215 | } |
1216 | else | |
1217 | { | |
1218 | printf_unfiltered ("%s\n%s\n", prompt_arg, END_MESSAGE); | |
1219 | gdb_flush (gdb_stdout); | |
1220 | } | |
d318976c FN |
1221 | } |
1222 | ||
c41535fd EZ |
1223 | |
1224 | /* Reading commands assumes the CLI behavior, so temporarily | |
1225 | override the current interpreter with CLI. */ | |
1226 | if (current_interp_named_p (INTERP_CONSOLE)) | |
1227 | head = read_command_lines_1 (read_next_line, parse_commands, | |
1228 | validator, closure); | |
1229 | else | |
1230 | { | |
1231 | struct interp *old_interp = interp_set_temp (INTERP_CONSOLE); | |
1232 | struct cleanup *old_chain = make_cleanup (restore_interp, old_interp); | |
1233 | ||
1234 | head = read_command_lines_1 (read_next_line, parse_commands, | |
1235 | validator, closure); | |
1236 | do_cleanups (old_chain); | |
1237 | } | |
3c1179ff | 1238 | |
268a799a PA |
1239 | if (from_tty && input_interactive_p (current_ui) |
1240 | && deprecated_readline_end_hook) | |
3c1179ff VP |
1241 | { |
1242 | (*deprecated_readline_end_hook) (); | |
1243 | } | |
1244 | return (head); | |
1245 | } | |
1246 | ||
1247 | /* Act the same way as read_command_lines, except that each new line is | |
1248 | obtained using READ_NEXT_LINE_FUNC. */ | |
1249 | ||
1250 | struct command_line * | |
a7bdde9e VP |
1251 | read_command_lines_1 (char * (*read_next_line_func) (void), int parse_commands, |
1252 | void (*validator)(char *, void *), void *closure) | |
3c1179ff VP |
1253 | { |
1254 | struct command_line *head, *tail, *next; | |
ac5007fd | 1255 | struct cleanup *old_chain = make_cleanup (null_cleanup, NULL); |
3c1179ff VP |
1256 | enum command_control_type ret; |
1257 | enum misc_command_type val; | |
1258 | ||
1259 | control_level = 0; | |
d318976c | 1260 | head = tail = NULL; |
d318976c FN |
1261 | |
1262 | while (1) | |
1263 | { | |
f429d7d0 | 1264 | dont_repeat (); |
a7bdde9e VP |
1265 | val = process_next_line (read_next_line_func (), &next, parse_commands, |
1266 | validator, closure); | |
d318976c FN |
1267 | |
1268 | /* Ignore blank lines or comments. */ | |
1269 | if (val == nop_command) | |
1270 | continue; | |
1271 | ||
1272 | if (val == end_command) | |
1273 | { | |
1274 | ret = simple_control; | |
1275 | break; | |
1276 | } | |
1277 | ||
1278 | if (val != ok_command) | |
1279 | { | |
1280 | ret = invalid_control; | |
1281 | break; | |
1282 | } | |
1283 | ||
1e9c71b8 | 1284 | if (multi_line_command_p (next->control_type)) |
d318976c FN |
1285 | { |
1286 | control_level++; | |
a7bdde9e VP |
1287 | ret = recurse_read_control_structure (read_next_line_func, next, |
1288 | validator, closure); | |
d318976c FN |
1289 | control_level--; |
1290 | ||
1291 | if (ret == invalid_control) | |
1292 | break; | |
1293 | } | |
1294 | ||
1295 | if (tail) | |
1296 | { | |
1297 | tail->next = next; | |
1298 | } | |
1299 | else | |
1300 | { | |
1301 | head = next; | |
ac5007fd | 1302 | make_cleanup_free_command_lines (&head); |
d318976c FN |
1303 | } |
1304 | tail = next; | |
1305 | } | |
1306 | ||
1307 | dont_repeat (); | |
1308 | ||
ac5007fd TT |
1309 | if (ret != invalid_control) |
1310 | discard_cleanups (old_chain); | |
1311 | else | |
1312 | do_cleanups (old_chain); | |
d318976c | 1313 | |
3c1179ff | 1314 | return head; |
d318976c FN |
1315 | } |
1316 | ||
1317 | /* Free a chain of struct command_line's. */ | |
1318 | ||
1319 | void | |
1320 | free_command_lines (struct command_line **lptr) | |
1321 | { | |
d5b5ac79 AC |
1322 | struct command_line *l = *lptr; |
1323 | struct command_line *next; | |
d318976c FN |
1324 | struct command_line **blist; |
1325 | int i; | |
1326 | ||
1327 | while (l) | |
1328 | { | |
1329 | if (l->body_count > 0) | |
1330 | { | |
1331 | blist = l->body_list; | |
1332 | for (i = 0; i < l->body_count; i++, blist++) | |
1333 | free_command_lines (blist); | |
1334 | } | |
1335 | next = l->next; | |
b8c9b27d KB |
1336 | xfree (l->line); |
1337 | xfree (l); | |
d318976c FN |
1338 | l = next; |
1339 | } | |
0d70f41b | 1340 | *lptr = NULL; |
d318976c FN |
1341 | } |
1342 | ||
1343 | static void | |
1344 | do_free_command_lines_cleanup (void *arg) | |
1345 | { | |
9a3c8263 | 1346 | free_command_lines ((struct command_line **) arg); |
d318976c FN |
1347 | } |
1348 | ||
6c50ab1c | 1349 | struct cleanup * |
d318976c FN |
1350 | make_cleanup_free_command_lines (struct command_line **arg) |
1351 | { | |
1352 | return make_cleanup (do_free_command_lines_cleanup, arg); | |
1353 | } | |
c2b8ed2c MS |
1354 | |
1355 | struct command_line * | |
1356 | copy_command_lines (struct command_line *cmds) | |
1357 | { | |
1358 | struct command_line *result = NULL; | |
1359 | ||
1360 | if (cmds) | |
1361 | { | |
8d749320 | 1362 | result = XNEW (struct command_line); |
c2b8ed2c MS |
1363 | |
1364 | result->next = copy_command_lines (cmds->next); | |
1365 | result->line = xstrdup (cmds->line); | |
1366 | result->control_type = cmds->control_type; | |
1367 | result->body_count = cmds->body_count; | |
1368 | if (cmds->body_count > 0) | |
1369 | { | |
1370 | int i; | |
1371 | ||
8d749320 | 1372 | result->body_list = XNEWVEC (struct command_line *, cmds->body_count); |
c2b8ed2c MS |
1373 | |
1374 | for (i = 0; i < cmds->body_count; i++) | |
1375 | result->body_list[i] = copy_command_lines (cmds->body_list[i]); | |
1376 | } | |
1377 | else | |
1378 | result->body_list = NULL; | |
1379 | } | |
1380 | ||
1381 | return result; | |
1382 | } | |
d318976c | 1383 | \f |
adb483fe DJ |
1384 | /* Validate that *COMNAME is a valid name for a command. Return the |
1385 | containing command list, in case it starts with a prefix command. | |
1386 | The prefix must already exist. *COMNAME is advanced to point after | |
1387 | any prefix, and a NUL character overwrites the space after the | |
1388 | prefix. */ | |
1389 | ||
1390 | static struct cmd_list_element ** | |
1391 | validate_comname (char **comname) | |
d318976c | 1392 | { |
adb483fe DJ |
1393 | struct cmd_list_element **list = &cmdlist; |
1394 | char *p, *last_word; | |
d318976c | 1395 | |
adb483fe | 1396 | if (*comname == 0) |
e2e0b3e5 | 1397 | error_no_arg (_("name of command to define")); |
d318976c | 1398 | |
adb483fe DJ |
1399 | /* Find the last word of the argument. */ |
1400 | p = *comname + strlen (*comname); | |
1401 | while (p > *comname && isspace (p[-1])) | |
1402 | p--; | |
1403 | while (p > *comname && !isspace (p[-1])) | |
1404 | p--; | |
1405 | last_word = p; | |
1406 | ||
1407 | /* Find the corresponding command list. */ | |
1408 | if (last_word != *comname) | |
1409 | { | |
1410 | struct cmd_list_element *c; | |
6f937416 PA |
1411 | char saved_char; |
1412 | const char *tem = *comname; | |
adb483fe DJ |
1413 | |
1414 | /* Separate the prefix and the command. */ | |
1415 | saved_char = last_word[-1]; | |
1416 | last_word[-1] = '\0'; | |
1417 | ||
1418 | c = lookup_cmd (&tem, cmdlist, "", 0, 1); | |
1419 | if (c->prefixlist == NULL) | |
1420 | error (_("\"%s\" is not a prefix command."), *comname); | |
1421 | ||
1422 | list = c->prefixlist; | |
1423 | last_word[-1] = saved_char; | |
1424 | *comname = last_word; | |
1425 | } | |
1426 | ||
1427 | p = *comname; | |
d318976c FN |
1428 | while (*p) |
1429 | { | |
1430 | if (!isalnum (*p) && *p != '-' && *p != '_') | |
8a3fe4f8 | 1431 | error (_("Junk in argument list: \"%s\""), p); |
d318976c FN |
1432 | p++; |
1433 | } | |
adb483fe DJ |
1434 | |
1435 | return list; | |
d318976c FN |
1436 | } |
1437 | ||
1438 | /* This is just a placeholder in the command data structures. */ | |
1439 | static void | |
1440 | user_defined_command (char *ignore, int from_tty) | |
1441 | { | |
1442 | } | |
1443 | ||
2370e853 | 1444 | static void |
d318976c FN |
1445 | define_command (char *comname, int from_tty) |
1446 | { | |
1447 | #define MAX_TMPBUF 128 | |
1448 | enum cmd_hook_type | |
1449 | { | |
1450 | CMD_NO_HOOK = 0, | |
1451 | CMD_PRE_HOOK, | |
1452 | CMD_POST_HOOK | |
1453 | }; | |
d5b5ac79 | 1454 | struct command_line *cmds; |
d36fc00b MS |
1455 | struct cmd_list_element *c, *newc, *hookc = 0, **list; |
1456 | char *tem, *comfull; | |
6f937416 | 1457 | const char *tem_c; |
d318976c FN |
1458 | char tmpbuf[MAX_TMPBUF]; |
1459 | int hook_type = CMD_NO_HOOK; | |
1460 | int hook_name_size = 0; | |
1461 | ||
1462 | #define HOOK_STRING "hook-" | |
1463 | #define HOOK_LEN 5 | |
1464 | #define HOOK_POST_STRING "hookpost-" | |
1465 | #define HOOK_POST_LEN 9 | |
1466 | ||
adb483fe DJ |
1467 | comfull = comname; |
1468 | list = validate_comname (&comname); | |
d318976c FN |
1469 | |
1470 | /* Look it up, and verify that we got an exact match. */ | |
6f937416 PA |
1471 | tem_c = comname; |
1472 | c = lookup_cmd (&tem_c, *list, "", -1, 1); | |
5cb316ef | 1473 | if (c && strcmp (comname, c->name) != 0) |
d318976c FN |
1474 | c = 0; |
1475 | ||
1476 | if (c) | |
1477 | { | |
ab4e3d93 | 1478 | int q; |
cdb27c12 | 1479 | |
fe978cb0 | 1480 | if (c->theclass == class_user || c->theclass == class_alias) |
e2e0b3e5 | 1481 | q = query (_("Redefine command \"%s\"? "), c->name); |
d318976c | 1482 | else |
e2e0b3e5 | 1483 | q = query (_("Really redefine built-in command \"%s\"? "), c->name); |
ab4e3d93 | 1484 | if (!q) |
8a3fe4f8 | 1485 | error (_("Command \"%s\" not redefined."), c->name); |
d318976c FN |
1486 | } |
1487 | ||
1488 | /* If this new command is a hook, then mark the command which it | |
1489 | is hooking. Note that we allow hooking `help' commands, so that | |
1490 | we can hook the `stop' pseudo-command. */ | |
1491 | ||
1492 | if (!strncmp (comname, HOOK_STRING, HOOK_LEN)) | |
1493 | { | |
1494 | hook_type = CMD_PRE_HOOK; | |
1495 | hook_name_size = HOOK_LEN; | |
1496 | } | |
1497 | else if (!strncmp (comname, HOOK_POST_STRING, HOOK_POST_LEN)) | |
1498 | { | |
1499 | hook_type = CMD_POST_HOOK; | |
1500 | hook_name_size = HOOK_POST_LEN; | |
1501 | } | |
1502 | ||
1503 | if (hook_type != CMD_NO_HOOK) | |
1504 | { | |
1505 | /* Look up cmd it hooks, and verify that we got an exact match. */ | |
6f937416 PA |
1506 | tem_c = comname + hook_name_size; |
1507 | hookc = lookup_cmd (&tem_c, *list, "", -1, 0); | |
5cb316ef | 1508 | if (hookc && strcmp (comname + hook_name_size, hookc->name) != 0) |
d318976c FN |
1509 | hookc = 0; |
1510 | if (!hookc) | |
1511 | { | |
9a2b4c1b MS |
1512 | warning (_("Your new `%s' command does not " |
1513 | "hook any existing command."), | |
adb483fe | 1514 | comfull); |
9e2f0ad4 | 1515 | if (!query (_("Proceed? "))) |
8a3fe4f8 | 1516 | error (_("Not confirmed.")); |
d318976c FN |
1517 | } |
1518 | } | |
1519 | ||
1b36a34b | 1520 | comname = xstrdup (comname); |
d318976c FN |
1521 | |
1522 | /* If the rest of the commands will be case insensitive, this one | |
ebcd3b23 | 1523 | should behave in the same manner. */ |
d318976c FN |
1524 | for (tem = comname; *tem; tem++) |
1525 | if (isupper (*tem)) | |
1526 | *tem = tolower (*tem); | |
1527 | ||
8c042590 PM |
1528 | xsnprintf (tmpbuf, sizeof (tmpbuf), |
1529 | "Type commands for definition of \"%s\".", comfull); | |
a7bdde9e | 1530 | cmds = read_command_lines (tmpbuf, from_tty, 1, 0, 0); |
d318976c | 1531 | |
fe978cb0 | 1532 | if (c && c->theclass == class_user) |
d318976c FN |
1533 | free_command_lines (&c->user_commands); |
1534 | ||
1535 | newc = add_cmd (comname, class_user, user_defined_command, | |
fe978cb0 | 1536 | (c && c->theclass == class_user) |
1b36a34b | 1537 | ? c->doc : xstrdup ("User-defined."), list); |
d318976c FN |
1538 | newc->user_commands = cmds; |
1539 | ||
1540 | /* If this new command is a hook, then mark both commands as being | |
1541 | tied. */ | |
1542 | if (hookc) | |
1543 | { | |
1544 | switch (hook_type) | |
1545 | { | |
1546 | case CMD_PRE_HOOK: | |
1547 | hookc->hook_pre = newc; /* Target gets hooked. */ | |
ebcd3b23 | 1548 | newc->hookee_pre = hookc; /* We are marked as hooking target cmd. */ |
d318976c FN |
1549 | break; |
1550 | case CMD_POST_HOOK: | |
f48ff60a | 1551 | hookc->hook_post = newc; /* Target gets hooked. */ |
9a2b4c1b MS |
1552 | newc->hookee_post = hookc; /* We are marked as hooking |
1553 | target cmd. */ | |
d318976c FN |
1554 | break; |
1555 | default: | |
ebcd3b23 | 1556 | /* Should never come here as hookc would be 0. */ |
e2e0b3e5 | 1557 | internal_error (__FILE__, __LINE__, _("bad switch")); |
d318976c FN |
1558 | } |
1559 | } | |
1560 | } | |
1561 | ||
2370e853 | 1562 | static void |
d318976c FN |
1563 | document_command (char *comname, int from_tty) |
1564 | { | |
1565 | struct command_line *doclines; | |
adb483fe | 1566 | struct cmd_list_element *c, **list; |
6f937416 PA |
1567 | const char *tem; |
1568 | char *comfull; | |
d318976c FN |
1569 | char tmpbuf[128]; |
1570 | ||
adb483fe DJ |
1571 | comfull = comname; |
1572 | list = validate_comname (&comname); | |
d318976c | 1573 | |
adb483fe DJ |
1574 | tem = comname; |
1575 | c = lookup_cmd (&tem, *list, "", 0, 1); | |
d318976c | 1576 | |
fe978cb0 | 1577 | if (c->theclass != class_user) |
adb483fe | 1578 | error (_("Command \"%s\" is built-in."), comfull); |
d318976c | 1579 | |
8c042590 PM |
1580 | xsnprintf (tmpbuf, sizeof (tmpbuf), "Type documentation for \"%s\".", |
1581 | comfull); | |
a7bdde9e | 1582 | doclines = read_command_lines (tmpbuf, from_tty, 0, 0, 0); |
d318976c FN |
1583 | |
1584 | if (c->doc) | |
1947513d | 1585 | xfree ((char *) c->doc); |
d318976c FN |
1586 | |
1587 | { | |
d5b5ac79 AC |
1588 | struct command_line *cl1; |
1589 | int len = 0; | |
1947513d | 1590 | char *doc; |
d318976c FN |
1591 | |
1592 | for (cl1 = doclines; cl1; cl1 = cl1->next) | |
1593 | len += strlen (cl1->line) + 1; | |
1594 | ||
1947513d TT |
1595 | doc = (char *) xmalloc (len + 1); |
1596 | *doc = 0; | |
d318976c FN |
1597 | |
1598 | for (cl1 = doclines; cl1; cl1 = cl1->next) | |
1599 | { | |
1947513d | 1600 | strcat (doc, cl1->line); |
d318976c | 1601 | if (cl1->next) |
1947513d | 1602 | strcat (doc, "\n"); |
d318976c | 1603 | } |
1947513d TT |
1604 | |
1605 | c->doc = doc; | |
d318976c FN |
1606 | } |
1607 | ||
1608 | free_command_lines (&doclines); | |
1609 | } | |
1610 | \f | |
1611 | struct source_cleanup_lines_args | |
1612 | { | |
1613 | int old_line; | |
05159abe | 1614 | const char *old_file; |
d318976c FN |
1615 | }; |
1616 | ||
1617 | static void | |
4efb68b1 | 1618 | source_cleanup_lines (void *args) |
d318976c FN |
1619 | { |
1620 | struct source_cleanup_lines_args *p = | |
cdb27c12 MS |
1621 | (struct source_cleanup_lines_args *) args; |
1622 | ||
d318976c FN |
1623 | source_line_number = p->old_line; |
1624 | source_file_name = p->old_file; | |
d318976c FN |
1625 | } |
1626 | ||
ebcd3b23 | 1627 | /* Used to implement source_command. */ |
d318976c FN |
1628 | |
1629 | void | |
05159abe | 1630 | script_from_file (FILE *stream, const char *file) |
d318976c FN |
1631 | { |
1632 | struct cleanup *old_cleanups; | |
1633 | struct source_cleanup_lines_args old_lines; | |
d318976c FN |
1634 | |
1635 | if (stream == NULL) | |
e2e0b3e5 | 1636 | internal_error (__FILE__, __LINE__, _("called with NULL file pointer!")); |
d318976c | 1637 | |
d318976c FN |
1638 | old_lines.old_line = source_line_number; |
1639 | old_lines.old_file = source_file_name; | |
86eb7e95 | 1640 | old_cleanups = make_cleanup (source_cleanup_lines, &old_lines); |
d318976c FN |
1641 | source_line_number = 0; |
1642 | source_file_name = file; | |
d318976c | 1643 | |
17d92a02 | 1644 | { |
b7b633e9 | 1645 | scoped_restore save_async = make_scoped_restore (¤t_ui->async, 0); |
cdb27c12 | 1646 | |
492d29ea | 1647 | TRY |
04bd08de TT |
1648 | { |
1649 | read_command_file (stream); | |
1650 | } | |
492d29ea | 1651 | CATCH (e, RETURN_MASK_ERROR) |
17d92a02 | 1652 | { |
17d92a02 AC |
1653 | /* Re-throw the error, but with the file name information |
1654 | prepended. */ | |
109c3e39 AC |
1655 | throw_error (e.error, |
1656 | _("%s:%d: Error in sourced command file:\n%s"), | |
637537d0 | 1657 | source_file_name, source_line_number, e.message); |
17d92a02 | 1658 | } |
492d29ea | 1659 | END_CATCH |
17d92a02 | 1660 | } |
d318976c FN |
1661 | |
1662 | do_cleanups (old_cleanups); | |
1663 | } | |
1664 | ||
adb483fe DJ |
1665 | /* Print the definition of user command C to STREAM. Or, if C is a |
1666 | prefix command, show the definitions of all user commands under C | |
1667 | (recursively). PREFIX and NAME combined are the name of the | |
1668 | current command. */ | |
d318976c | 1669 | void |
6f937416 | 1670 | show_user_1 (struct cmd_list_element *c, const char *prefix, const char *name, |
adb483fe | 1671 | struct ui_file *stream) |
d318976c | 1672 | { |
d5b5ac79 | 1673 | struct command_line *cmdlines; |
d318976c | 1674 | |
adb483fe DJ |
1675 | if (c->prefixlist != NULL) |
1676 | { | |
64e61d29 | 1677 | const char *prefixname = c->prefixname; |
cdb27c12 | 1678 | |
adb483fe | 1679 | for (c = *c->prefixlist; c != NULL; c = c->next) |
fe978cb0 | 1680 | if (c->theclass == class_user || c->prefixlist != NULL) |
adb483fe DJ |
1681 | show_user_1 (c, prefixname, c->name, gdb_stdout); |
1682 | return; | |
1683 | } | |
1684 | ||
d318976c | 1685 | cmdlines = c->user_commands; |
adb483fe | 1686 | fprintf_filtered (stream, "User command \"%s%s\":\n", prefix, name); |
d318976c | 1687 | |
a9f116cb GKB |
1688 | if (!cmdlines) |
1689 | return; | |
79a45e25 | 1690 | print_command_lines (current_uiout, cmdlines, 1); |
d318976c | 1691 | fputs_filtered ("\n", stream); |
d318976c FN |
1692 | } |
1693 | ||
2370e853 TT |
1694 | \f |
1695 | ||
1696 | initialize_file_ftype _initialize_cli_script; | |
1697 | ||
1698 | void | |
1699 | _initialize_cli_script (void) | |
1700 | { | |
1701 | add_com ("document", class_support, document_command, _("\ | |
1702 | Document a user-defined command.\n\ | |
1703 | Give command name as argument. Give documentation on following lines.\n\ | |
1704 | End with a line of just \"end\".")); | |
1705 | add_com ("define", class_support, define_command, _("\ | |
1706 | Define a new command name. Command name is argument.\n\ | |
1707 | Definition appears on following lines, one command per line.\n\ | |
1708 | End with a line of just \"end\".\n\ | |
1709 | Use the \"document\" command to give documentation for the new command.\n\ | |
1710 | Commands defined in this way may have up to ten arguments.")); | |
1711 | ||
1712 | add_com ("while", class_support, while_command, _("\ | |
1713 | Execute nested commands WHILE the conditional expression is non zero.\n\ | |
1714 | The conditional expression must follow the word `while' and must in turn be\n\ | |
1715 | followed by a new line. The nested commands must be entered one per line,\n\ | |
1716 | and should be terminated by the word `end'.")); | |
1717 | ||
1718 | add_com ("if", class_support, if_command, _("\ | |
1719 | Execute nested commands once IF the conditional expression is non zero.\n\ | |
1720 | The conditional expression must follow the word `if' and must in turn be\n\ | |
1721 | followed by a new line. The nested commands must be entered one per line,\n\ | |
1722 | and should be terminated by the word 'else' or `end'. If an else clause\n\ | |
1723 | is used, the same rules apply to its nested commands as to the first ones.")); | |
1724 | } |