diff options
Diffstat (limited to 'gdb/defs.h')
| -rw-r--r-- | gdb/defs.h | 81 |
1 files changed, 40 insertions, 41 deletions
@@ -78,9 +78,9 @@ /* The O_BINARY flag is defined in fcntl.h on some non-Posix platforms. It is used as an access modifier in calls to open(), where it acts - similarly to the "b" character in fopen()'s MODE argument. On Posix - platforms it should be a no-op, so it is defined as 0 here. This - ensures that the symbol may be used freely elsewhere in gdb. */ + similarly to the "b" character in fopen()'s MODE argument. On Posix + platforms it should be a no-op, so it is defined as 0 here. This + ensures that the symbol may be used freely elsewhere in gdb. */ #ifndef O_BINARY #define O_BINARY 0 @@ -145,10 +145,10 @@ typedef bfd_vma CORE_ADDR; /* Check if a character is one of the commonly used C++ marker characters. */ extern int is_cplus_marker (int); -/* enable xdb commands if set */ +/* Enable xdb commands if set. */ extern int xdb_commands; -/* enable dbx commands if set */ +/* Enable dbx commands if set. */ extern int dbx_commands; /* System root path, used to find libraries etc. */ @@ -175,7 +175,7 @@ extern void quit (void); marginal. If the overhead of a QUIT function call is proving significant then its calling frequency should probably be reduced [kingdon]. A profile analyzing the current situtation is - needed. */ + needed. */ #define QUIT { \ if (quit_flag) quit (); \ @@ -185,7 +185,7 @@ extern void quit (void); /* Languages represented in the symbol table and elsewhere. This should probably be in language.h, but since enum's can't be forward declared to satisfy opaque references before their - actual definition, needs to be here. */ + actual definition, needs to be here. */ enum language { @@ -256,7 +256,7 @@ enum return_value_convention Use make_cleanup to add an element to the cleanup chain. Use do_cleanups to do all cleanup actions back to a given point in the chain. Use discard_cleanups to remove cleanups - from the chain back to a given point, not doing them. + from the chain back to a given point, not doing them. If the argument is pointer to allocated memory, then you need to to additionally set the 'free_arg' member to a function that will @@ -321,10 +321,10 @@ extern void discard_final_cleanups (struct cleanup *); extern void discard_my_cleanups (struct cleanup **, struct cleanup *); /* NOTE: cagney/2000-03-04: This typedef is strictly for the - make_cleanup function declarations below. Do not use this typedef + make_cleanup function declarations below. Do not use this typedef as a cast when passing functions into the make_cleanup() code. Instead either use a bounce function or add a wrapper function. - Calling a f(char*) function with f(void*) is non-portable. */ + Calling a f(char*) function with f(void*) is non-portable. */ typedef void (make_cleanup_ftype) (void *); extern struct cleanup *make_cleanup (make_cleanup_ftype *, void *); @@ -444,13 +444,13 @@ extern struct ui_file *gdb_stdin; extern struct ui_file *gdb_stderr; /* Log/debug/trace messages that should bypass normal stdout/stderr filtering. For moment, always call this stream using - *_unfiltered. In the very near future that restriction shall be - removed - either call shall be unfiltered. (cagney 1999-06-13). */ + *_unfiltered. In the very near future that restriction shall be + removed - either call shall be unfiltered. (cagney 1999-06-13). */ extern struct ui_file *gdb_stdlog; /* Target output that should bypass normal stdout/stderr filtering. - For moment, always call this stream using *_unfiltered. In the + For moment, always call this stream using *_unfiltered. In the very near future that restriction shall be removed - either call - shall be unfiltered. (cagney 1999-07-02). */ + shall be unfiltered. (cagney 1999-07-02). */ extern struct ui_file *gdb_stdtarg; extern struct ui_file *gdb_stdtargerr; extern struct ui_file *gdb_stdtargin; @@ -523,7 +523,7 @@ extern void fputstrn_filtered (const char *str, int n, int quotr, extern void fputstrn_unfiltered (const char *str, int n, int quotr, struct ui_file * stream); -/* Display the host ADDR on STREAM formatted as ``0x%x''. */ +/* Display the host ADDR on STREAM formatted as ``0x%x''. */ extern void gdb_print_host_address (const void *addr, struct ui_file *stream); extern const char *host_address_to_string (const void *addr); @@ -574,7 +574,7 @@ extern void symbol_file_command (char *, int); extern void generic_load (char *name, int from_tty); /* Report on STREAM the performance of memory transfer operation, - such as 'load'. + such as 'load'. DATA_COUNT is the number of bytes transferred. WRITE_COUNT is the number of separate write operations, or 0, if that information is not available. @@ -651,16 +651,16 @@ typedef int (*find_memory_region_ftype) (CORE_ADDR addr, unsigned long size, int read, int write, int exec, void *data); -/* Take over the 'find_mapped_memory' vector from exec.c. */ +/* Take over the 'find_mapped_memory' vector from exec.c. */ extern void exec_set_find_memory_regions (int (*func) (find_memory_region_ftype func, void *data)); /* Possible lvalue types. Like enum language, this should be in - value.h, but needs to be here for the same reason. */ + value.h, but needs to be here for the same reason. */ enum lval_type { - /* Not an lval. */ + /* Not an lval. */ not_lval, /* In memory. */ lval_memory, @@ -708,10 +708,9 @@ struct command_line enum command_control_type control_type; /* The number of elements in body_list. */ int body_count; - /* For composite commands, the nested lists of - commands. For example, for "if" command this - will contain the then branch and the else - branch, if that is available. */ + /* For composite commands, the nested lists of commands. For + example, for "if" command this will contain the then branch and + the else branch, if that is available. */ struct command_line **body_list; }; @@ -724,11 +723,11 @@ extern struct command_line *read_command_lines_1 (char * (*) (void), int, extern void free_command_lines (struct command_line **); -/* To continue the execution commands when running gdb asynchronously. +/* To continue the execution commands when running gdb asynchronously. A continuation structure contains a pointer to a function to be called - to finish the command, once the target has stopped. Such mechanism is + to finish the command, once the target has stopped. Such mechanism is used by the finish and until commands, and in the remote protocol - when opening an extended-remote connection. */ + when opening an extended-remote connection. */ struct continuation; struct thread_info; @@ -774,7 +773,7 @@ extern unsigned output_radix; things. Like enum language, this should be in value.h, but needs to be here for the same reason. FIXME: If we can eliminate this as an arg to LA_VAL_PRINT, then we can probably move it back to - value.h. */ + value.h. */ enum val_prettyprint { @@ -841,26 +840,26 @@ typedef struct ptid ptid_t; #endif /* Defaults for system-wide constants (if not defined by xm.h, we fake it). - FIXME: Assumes 2's complement arithmetic */ + FIXME: Assumes 2's complement arithmetic. */ #if !defined (UINT_MAX) -#define UINT_MAX ((unsigned int)(~0)) /* 0xFFFFFFFF for 32-bits */ +#define UINT_MAX ((unsigned int)(~0)) /* 0xFFFFFFFF for 32-bits */ #endif #if !defined (INT_MAX) -#define INT_MAX ((int)(UINT_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */ +#define INT_MAX ((int)(UINT_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */ #endif #if !defined (INT_MIN) -#define INT_MIN ((int)((int) ~0 ^ INT_MAX)) /* 0x80000000 for 32-bits */ +#define INT_MIN ((int)((int) ~0 ^ INT_MAX)) /* 0x80000000 for 32-bits */ #endif #if !defined (ULONG_MAX) -#define ULONG_MAX ((unsigned long)(~0L)) /* 0xFFFFFFFF for 32-bits */ +#define ULONG_MAX ((unsigned long)(~0L)) /* 0xFFFFFFFF for 32-bits */ #endif #if !defined (LONG_MAX) -#define LONG_MAX ((long)(ULONG_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */ +#define LONG_MAX ((long)(ULONG_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */ #endif #if !defined (ULONGEST_MAX) @@ -883,7 +882,7 @@ extern int longest_to_int (LONGEST); extern char *savestring (const char *, size_t); /* xmalloc(), xrealloc() and xcalloc() have already been declared in - "libiberty.h". */ + "libiberty.h". */ extern void xfree (void *); /* Like xmalloc, but zero the memory. */ @@ -897,7 +896,7 @@ extern void *xzalloc (size_t); #define XCALLOC(NMEMB, TYPE) ((TYPE*) xcalloc ((NMEMB), sizeof (TYPE))) /* Like asprintf/vasprintf but get an internal_error if the call - fails. */ + fails. */ extern void xasprintf (char **ret, const char *format, ...) ATTRIBUTE_PRINTF (2, 3); extern void xvasprintf (char **ret, const char *format, va_list ap) @@ -1041,7 +1040,7 @@ extern void *alloca (); #endif /* Not GNU C */ #endif /* alloca not defined */ -/* Dynamic target-system-dependent parameters for GDB. */ +/* Dynamic target-system-dependent parameters for GDB. */ #include "gdbarch.h" /* Maximum size of a register. Something small, but large enough for @@ -1049,7 +1048,7 @@ extern void *alloca (); enum { MAX_REGISTER_SIZE = 64 }; -/* Static target-system-dependent parameters for GDB. */ +/* Static target-system-dependent parameters for GDB. */ /* Number of bits in a char or unsigned char for the target machine. Just like CHAR_BIT in <limits.h> but describes the target machine. */ @@ -1060,7 +1059,7 @@ enum { MAX_REGISTER_SIZE = 64 }; /* If we picked up a copy of CHAR_BIT from a configuration file (which may get it by including <limits.h>) then use it to set the number of bits in a host char. If not, use the same size - as the target. */ + as the target. */ #if defined (CHAR_BIT) #define HOST_CHAR_BIT CHAR_BIT @@ -1098,14 +1097,14 @@ extern int watchdog; /* Hooks for alternate command interfaces. */ -/* The name of the interpreter if specified on the command line. */ +/* The name of the interpreter if specified on the command line. */ extern char *interpreter_p; /* If a given interpreter matches INTERPRETER_P then it should update deprecated_command_loop_hook and deprecated_init_ui_hook with the per-interpreter implementation. */ /* FIXME: deprecated_command_loop_hook and deprecated_init_ui_hook - should be moved here. */ + should be moved here. */ struct target_waitstatus; struct cmd_list_element; @@ -1154,7 +1153,7 @@ extern int (*deprecated_ui_load_progress_hook) (const char *section, unsigned long num); -/* Inhibit window interface if non-zero. */ +/* Inhibit window interface if non-zero. */ extern int use_windows; |