visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commits
1 Branch
Tree: 898a39b5ab
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '898a39b5ab'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gdb/Output-Styling.html

206 lines
9.1KB
Raw Blame History 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- Copyright (C) 1988-2020 Free Software Foundation, Inc.

  4. 

  5. Permission is granted to copy, distribute and/or modify this document

  6. under the terms of the GNU Free Documentation License, Version 1.3 or

  7. any later version published by the Free Software Foundation; with the

  8. Invariant Sections being "Free Software" and "Free Software Needs

  9. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"

  10. and with the Back-Cover Texts as in (a) below.

  11. 

  12. (a) The FSF's Back-Cover Text is: "You are free to copy and modify

  13. this GNU Manual.  Buying copies from GNU Press supports the FSF in

  14. developing GNU and promoting software freedom." -->

  15. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  16. <head>

  17. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  18. <title>Output Styling (Debugging with GDB)</title>

  19. 

  20. <meta name="description" content="Output Styling (Debugging with GDB)">

  21. <meta name="keywords" content="Output Styling (Debugging with GDB)">

  22. <meta name="resource-type" content="document">

  23. <meta name="distribution" content="global">

  24. <meta name="Generator" content="makeinfo">

  25. <link href="index.html#Top" rel="start" title="Top">

  26. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">

  27. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  28. <link href="Controlling-GDB.html#Controlling-GDB" rel="up" title="Controlling GDB">

  29. <link href="Numbers.html#Numbers" rel="next" title="Numbers">

  30. <link href="Screen-Size.html#Screen-Size" rel="prev" title="Screen Size">

  31. <style type="text/css">

  32. <!--

  33. a.summary-letter {text-decoration: none}

  34. blockquote.indentedblock {margin-right: 0em}

  35. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  36. blockquote.smallquotation {font-size: smaller}

  37. div.display {margin-left: 3.2em}

  38. div.example {margin-left: 3.2em}

  39. div.lisp {margin-left: 3.2em}

  40. div.smalldisplay {margin-left: 3.2em}

  41. div.smallexample {margin-left: 3.2em}

  42. div.smalllisp {margin-left: 3.2em}

  43. kbd {font-style: oblique}

  44. pre.display {font-family: inherit}

  45. pre.format {font-family: inherit}

  46. pre.menu-comment {font-family: serif}

  47. pre.menu-preformatted {font-family: serif}

  48. pre.smalldisplay {font-family: inherit; font-size: smaller}

  49. pre.smallexample {font-size: smaller}

  50. pre.smallformat {font-family: inherit; font-size: smaller}

  51. pre.smalllisp {font-size: smaller}

  52. span.nolinebreak {white-space: nowrap}

  53. span.roman {font-family: initial; font-weight: normal}

  54. span.sansserif {font-family: sans-serif; font-weight: normal}

  55. ul.no-bullet {list-style: none}

  56. -->

  57. </style>

  58. 

  59. 

  60. </head>

  61. 

  62. <body lang="en">

  63. <a name="Output-Styling"></a>

  64. <div class="header">

  65. <p>

  66. Next: <a href="Numbers.html#Numbers" accesskey="n" rel="next">Numbers</a>, Previous: <a href="Screen-Size.html#Screen-Size" accesskey="p" rel="prev">Screen Size</a>, Up: <a href="Controlling-GDB.html#Controlling-GDB" accesskey="u" rel="up">Controlling GDB</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>

  67. </div>

  68. <hr>

  69. <a name="Output-Styling-1"></a>

  70. <h3 class="section">22.5 Output Styling</h3>

  71. <a name="index-styling"></a>

  72. <a name="index-colors"></a>

  73. 

  74. <a name="index-set-style"></a>

  75. <a name="index-show-style"></a>

  76. <p><small>GDB</small> can style its output on a capable terminal.  This is

  77. enabled by default on most systems, but disabled by default when in

  78. batch mode (see <a href="Mode-Options.html#Mode-Options">Mode Options</a>).  Various style settings are available;

  79. and styles can also be disabled entirely.

  80. </p>

  81. <dl compact="compact">

  82. <dt><code>set style enabled &lsquo;<samp>on|off</samp>&rsquo;</code></dt>

  83. <dd><p>Enable or disable all styling.  The default is host-dependent, with

  84. most hosts defaulting to &lsquo;<samp>on</samp>&rsquo;.

  85. </p>

  86. </dd>

  87. <dt><code>show style enabled</code></dt>

  88. <dd><p>Show the current state of styling.

  89. </p>

  90. </dd>

  91. <dt><code>set style sources &lsquo;<samp>on|off</samp>&rsquo;</code></dt>

  92. <dd><p>Enable or disable source code styling.  This affects whether source

  93. code, such as the output of the <code>list</code> command, is styled.  Note

  94. that source styling only works if styling in general is enabled, and

  95. if <small>GDB</small> was linked with the GNU Source Highlight library.  The

  96. default is &lsquo;<samp>on</samp>&rsquo;.

  97. </p>

  98. </dd>

  99. <dt><code>show style sources</code></dt>

  100. <dd><p>Show the current state of source code styling.

  101. </p></dd>

  102. </dl>

  103. 

  104. <p>Subcommands of <code>set style</code> control specific forms of styling.

  105. These subcommands all follow the same pattern: each style-able object

  106. can be styled with a foreground color, a background color, and an

  107. intensity.

  108. </p>

  109. <p>For example, the style of file names can be controlled using the

  110. <code>set style filename</code> group of commands:

  111. </p>

  112. <dl compact="compact">

  113. <dt><code>set style filename background <var>color</var></code></dt>

  114. <dd><p>Set the background to <var>color</var>.  Valid colors are &lsquo;<samp>none</samp>&rsquo;

  115. (meaning the terminal&rsquo;s default color), &lsquo;<samp>black</samp>&rsquo;, &lsquo;<samp>red</samp>&rsquo;,

  116. &lsquo;<samp>green</samp>&rsquo;, &lsquo;<samp>yellow</samp>&rsquo;, &lsquo;<samp>blue</samp>&rsquo;, &lsquo;<samp>magenta</samp>&rsquo;, &lsquo;<samp>cyan</samp>&rsquo;,

  117. and&lsquo;<samp>white</samp>&rsquo;.

  118. </p>

  119. </dd>

  120. <dt><code>set style filename foreground <var>color</var></code></dt>

  121. <dd><p>Set the foreground to <var>color</var>.  Valid colors are &lsquo;<samp>none</samp>&rsquo;

  122. (meaning the terminal&rsquo;s default color), &lsquo;<samp>black</samp>&rsquo;, &lsquo;<samp>red</samp>&rsquo;,

  123. &lsquo;<samp>green</samp>&rsquo;, &lsquo;<samp>yellow</samp>&rsquo;, &lsquo;<samp>blue</samp>&rsquo;, &lsquo;<samp>magenta</samp>&rsquo;, &lsquo;<samp>cyan</samp>&rsquo;,

  124. and&lsquo;<samp>white</samp>&rsquo;.

  125. </p>

  126. </dd>

  127. <dt><code>set style filename intensity <var>value</var></code></dt>

  128. <dd><p>Set the intensity to <var>value</var>.  Valid intensities are &lsquo;<samp>normal</samp>&rsquo;

  129. (the default), &lsquo;<samp>bold</samp>&rsquo;, and &lsquo;<samp>dim</samp>&rsquo;.

  130. </p></dd>

  131. </dl>

  132. 

  133. <p>The <code>show style</code> command and its subcommands are styling

  134. a style name in their output using its own style.

  135. So, use <code>show style</code> to see the complete list of styles,

  136. their characteristics and the visual aspect of each style.

  137. </p>

  138. <p>The style-able objects are:

  139. </p><dl compact="compact">

  140. <dt><code>filename</code></dt>

  141. <dd><p>Control the styling of file names.  By default, this style&rsquo;s

  142. foreground color is green.

  143. </p>

  144. </dd>

  145. <dt><code>function</code></dt>

  146. <dd><p>Control the styling of function names.  These are managed with the

  147. <code>set style function</code> family of commands.  By default, this

  148. style&rsquo;s foreground color is yellow.

  149. </p>

  150. </dd>

  151. <dt><code>variable</code></dt>

  152. <dd><p>Control the styling of variable names.  These are managed with the

  153. <code>set style variable</code> family of commands.  By default, this style&rsquo;s

  154. foreground color is cyan.

  155. </p>

  156. </dd>

  157. <dt><code>address</code></dt>

  158. <dd><p>Control the styling of addresses.  These are managed with the

  159. <code>set style address</code> family of commands.  By default, this style&rsquo;s

  160. foreground color is blue.

  161. </p>

  162. </dd>

  163. <dt><code>title</code></dt>

  164. <dd><p>Control the styling of titles.  These are managed with the

  165. <code>set style title</code> family of commands.  By default, this style&rsquo;s

  166. intensity is bold.  Commands are using the title style to improve

  167. the readability of large output.  For example, the commands

  168. <code>apropos</code> and <code>help</code> are using the title style

  169. for the command names.

  170. </p>

  171. </dd>

  172. <dt><code>highlight</code></dt>

  173. <dd><p>Control the styling of highlightings.  These are managed with the

  174. <code>set style highlight</code> family of commands.  By default, this style&rsquo;s

  175. foreground color is red.  Commands are using the highlight style to draw

  176. the user attention to some specific parts of their output.  For example,

  177. the command <code>apropos -v REGEXP</code> uses the highlight style to

  178. mark the documentation parts matching <var>regexp</var>.

  179. </p>

  180. </dd>

  181. <dt><code>tui-border</code></dt>

  182. <dd><p>Control the styling of the TUI border.  Note that, unlike other

  183. styling options, only the color of the border can be controlled via

  184. <code>set style</code>.  This was done for compatibility reasons, as TUI

  185. controls to set the border&rsquo;s intensity predated the addition of

  186. general styling to <small>GDB</small>.  See <a href="TUI-Configuration.html#TUI-Configuration">TUI Configuration</a>.

  187. </p>

  188. </dd>

  189. <dt><code>tui-active-border</code></dt>

  190. <dd><p>Control the styling of the active TUI border; that is, the TUI window

  191. that has the focus.

  192. </p>

  193. </dd>

  194. </dl>

  195. 

  196. <hr>

  197. <div class="header">

  198. <p>

  199. Next: <a href="Numbers.html#Numbers" accesskey="n" rel="next">Numbers</a>, Previous: <a href="Screen-Size.html#Screen-Size" accesskey="p" rel="prev">Screen Size</a>, Up: <a href="Controlling-GDB.html#Controlling-GDB" accesskey="u" rel="up">Controlling GDB</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>

  200. </div>

  201. 

  202. 

  203. 

  204. </body>

  205. </html>