Allow gdb functions to specify where a line should wrap if it

exceeds the size of a terminal line.  Use it to make the output
        prettier.
This commit is contained in:
John Gilmore 1991-01-20 03:59:13 +00:00
parent a58d77add9
commit bbb5013f21
1 changed files with 22 additions and 1 deletions

View File

@ -2,7 +2,7 @@ GDB Internals documentation
This needs to be wrapped in texinfo stuff... This needs to be wrapped in texinfo stuff...
Cleanups Cleanups
Cleanups are a structured way to deal with things that need to be done Cleanups are a structured way to deal with things that need to be done
later. When your code does something (like malloc some memory, or open later. When your code does something (like malloc some memory, or open
@ -45,6 +45,27 @@ since they might never return to your code (they "longjmp" instead).
Wrapping output lines
Output that goes through printf_filtered or fputs_filtered or
fputs_demangled needs only to have calls to wrap_here() added
in places that would be good breaking points. The utility routines
will take care of actually wrapping if the line width is exceeded.
The argument to wrap_here() is an indentation string which is printed
ONLY if the line breaks there. This argument is saved away and used
later. It must remain valid until the next call to wrap_here() or
until a newline has been printed through the *_filtered functions.
Don't pass in a local variable and then return!
It is usually best to call wrap_here() after printing a comma or space.
If you call it before printing a space, make sure that your indentation
properly accounts for the leading space that will print if the line wraps
there.
Configuring GDB for release Configuring GDB for release