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.

Commands-For-History.html 9.5KB

3 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  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. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Free Software" and "Free Software Needs
  8. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
  9. and with the Back-Cover Texts as in (a) below.
  10. (a) The FSF's Back-Cover Text is: "You are free to copy and modify
  11. this GNU Manual. Buying copies from GNU Press supports the FSF in
  12. developing GNU and promoting software freedom." -->
  13. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
  14. <head>
  15. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  16. <title>Commands For History (Debugging with GDB)</title>
  17. <meta name="description" content="Commands For History (Debugging with GDB)">
  18. <meta name="keywords" content="Commands For History (Debugging with GDB)">
  19. <meta name="resource-type" content="document">
  20. <meta name="distribution" content="global">
  21. <meta name="Generator" content="makeinfo">
  22. <link href="index.html#Top" rel="start" title="Top">
  23. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
  24. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  25. <link href="Bindable-Readline-Commands.html#Bindable-Readline-Commands" rel="up" title="Bindable Readline Commands">
  26. <link href="Commands-For-Text.html#Commands-For-Text" rel="next" title="Commands For Text">
  27. <link href="Commands-For-Moving.html#Commands-For-Moving" rel="prev" title="Commands For Moving">
  28. <style type="text/css">
  29. <!--
  30. a.summary-letter {text-decoration: none}
  31. blockquote.indentedblock {margin-right: 0em}
  32. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
  33. blockquote.smallquotation {font-size: smaller}
  34. div.display {margin-left: 3.2em}
  35. div.example {margin-left: 3.2em}
  36. div.lisp {margin-left: 3.2em}
  37. div.smalldisplay {margin-left: 3.2em}
  38. div.smallexample {margin-left: 3.2em}
  39. div.smalllisp {margin-left: 3.2em}
  40. kbd {font-style: oblique}
  41. pre.display {font-family: inherit}
  42. pre.format {font-family: inherit}
  43. pre.menu-comment {font-family: serif}
  44. pre.menu-preformatted {font-family: serif}
  45. pre.smalldisplay {font-family: inherit; font-size: smaller}
  46. pre.smallexample {font-size: smaller}
  47. pre.smallformat {font-family: inherit; font-size: smaller}
  48. pre.smalllisp {font-size: smaller}
  49. span.nolinebreak {white-space: nowrap}
  50. span.roman {font-family: initial; font-weight: normal}
  51. span.sansserif {font-family: sans-serif; font-weight: normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en">
  57. <a name="Commands-For-History"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Commands-For-Text.html#Commands-For-Text" accesskey="n" rel="next">Commands For Text</a>, Previous: <a href="Commands-For-Moving.html#Commands-For-Moving" accesskey="p" rel="prev">Commands For Moving</a>, Up: <a href="Bindable-Readline-Commands.html#Bindable-Readline-Commands" accesskey="u" rel="up">Bindable Readline Commands</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>
  61. </div>
  62. <hr>
  63. <a name="Commands-For-Manipulating-The-History"></a>
  64. <h4 class="subsection">32.4.2 Commands For Manipulating The History</h4>
  65. <dl compact="compact">
  66. <dt><code>accept-line (Newline or Return)</code>
  67. <a name="index-accept_002dline-_0028Newline-or-Return_0029"></a>
  68. </dt>
  69. <dd><p>Accept the line regardless of where the cursor is.
  70. If this line is
  71. non-empty, it may be added to the history list for future recall with
  72. <code>add_history()</code>.
  73. If this line is a modified history line, the history line is restored
  74. to its original state.
  75. </p>
  76. </dd>
  77. <dt><code>previous-history (C-p)</code>
  78. <a name="index-previous_002dhistory-_0028C_002dp_0029"></a>
  79. </dt>
  80. <dd><p>Move &lsquo;back&rsquo; through the history list, fetching the previous command.
  81. </p>
  82. </dd>
  83. <dt><code>next-history (C-n)</code>
  84. <a name="index-next_002dhistory-_0028C_002dn_0029"></a>
  85. </dt>
  86. <dd><p>Move &lsquo;forward&rsquo; through the history list, fetching the next command.
  87. </p>
  88. </dd>
  89. <dt><code>beginning-of-history (M-&lt;)</code>
  90. <a name="index-beginning_002dof_002dhistory-_0028M_002d_003c_0029"></a>
  91. </dt>
  92. <dd><p>Move to the first line in the history.
  93. </p>
  94. </dd>
  95. <dt><code>end-of-history (M-&gt;)</code>
  96. <a name="index-end_002dof_002dhistory-_0028M_002d_003e_0029"></a>
  97. </dt>
  98. <dd><p>Move to the end of the input history, i.e., the line currently
  99. being entered.
  100. </p>
  101. </dd>
  102. <dt><code>reverse-search-history (C-r)</code>
  103. <a name="index-reverse_002dsearch_002dhistory-_0028C_002dr_0029"></a>
  104. </dt>
  105. <dd><p>Search backward starting at the current line and moving &lsquo;up&rsquo; through
  106. the history as necessary. This is an incremental search.
  107. </p>
  108. </dd>
  109. <dt><code>forward-search-history (C-s)</code>
  110. <a name="index-forward_002dsearch_002dhistory-_0028C_002ds_0029"></a>
  111. </dt>
  112. <dd><p>Search forward starting at the current line and moving &lsquo;down&rsquo; through
  113. the history as necessary. This is an incremental search.
  114. </p>
  115. </dd>
  116. <dt><code>non-incremental-reverse-search-history (M-p)</code>
  117. <a name="index-non_002dincremental_002dreverse_002dsearch_002dhistory-_0028M_002dp_0029"></a>
  118. </dt>
  119. <dd><p>Search backward starting at the current line and moving &lsquo;up&rsquo;
  120. through the history as necessary using a non-incremental search
  121. for a string supplied by the user.
  122. The search string may match anywhere in a history line.
  123. </p>
  124. </dd>
  125. <dt><code>non-incremental-forward-search-history (M-n)</code>
  126. <a name="index-non_002dincremental_002dforward_002dsearch_002dhistory-_0028M_002dn_0029"></a>
  127. </dt>
  128. <dd><p>Search forward starting at the current line and moving &lsquo;down&rsquo;
  129. through the history as necessary using a non-incremental search
  130. for a string supplied by the user.
  131. The search string may match anywhere in a history line.
  132. </p>
  133. </dd>
  134. <dt><code>history-search-forward ()</code>
  135. <a name="index-history_002dsearch_002dforward-_0028_0029"></a>
  136. </dt>
  137. <dd><p>Search forward through the history for the string of characters
  138. between the start of the current line and the point.
  139. The search string must match at the beginning of a history line.
  140. This is a non-incremental search.
  141. By default, this command is unbound.
  142. </p>
  143. </dd>
  144. <dt><code>history-search-backward ()</code>
  145. <a name="index-history_002dsearch_002dbackward-_0028_0029"></a>
  146. </dt>
  147. <dd><p>Search backward through the history for the string of characters
  148. between the start of the current line and the point.
  149. The search string must match at the beginning of a history line.
  150. This is a non-incremental search.
  151. By default, this command is unbound.
  152. </p>
  153. </dd>
  154. <dt><code>history-substring-search-forward ()</code>
  155. <a name="index-history_002dsubstring_002dsearch_002dforward-_0028_0029"></a>
  156. </dt>
  157. <dd><p>Search forward through the history for the string of characters
  158. between the start of the current line and the point.
  159. The search string may match anywhere in a history line.
  160. This is a non-incremental search.
  161. By default, this command is unbound.
  162. </p>
  163. </dd>
  164. <dt><code>history-substring-search-backward ()</code>
  165. <a name="index-history_002dsubstring_002dsearch_002dbackward-_0028_0029"></a>
  166. </dt>
  167. <dd><p>Search backward through the history for the string of characters
  168. between the start of the current line and the point.
  169. The search string may match anywhere in a history line.
  170. This is a non-incremental search.
  171. By default, this command is unbound.
  172. </p>
  173. </dd>
  174. <dt><code>yank-nth-arg (M-C-y)</code>
  175. <a name="index-yank_002dnth_002darg-_0028M_002dC_002dy_0029"></a>
  176. </dt>
  177. <dd><p>Insert the first argument to the previous command (usually
  178. the second word on the previous line) at point.
  179. With an argument <var>n</var>,
  180. insert the <var>n</var>th word from the previous command (the words
  181. in the previous command begin with word 0). A negative argument
  182. inserts the <var>n</var>th word from the end of the previous command.
  183. Once the argument <var>n</var> is computed, the argument is extracted
  184. as if the &lsquo;<samp>!<var>n</var></samp>&rsquo; history expansion had been specified.
  185. </p>
  186. </dd>
  187. <dt><code>yank-last-arg (M-. or M-_)</code>
  188. <a name="index-yank_002dlast_002darg-_0028M_002d_002e-or-M_002d_005f_0029"></a>
  189. </dt>
  190. <dd><p>Insert last argument to the previous command (the last word of the
  191. previous history entry).
  192. With a numeric argument, behave exactly like <code>yank-nth-arg</code>.
  193. Successive calls to <code>yank-last-arg</code> move back through the history
  194. list, inserting the last word (or the word specified by the argument to
  195. the first call) of each line in turn.
  196. Any numeric argument supplied to these successive calls determines
  197. the direction to move through the history. A negative argument switches
  198. the direction through the history (back or forward).
  199. The history expansion facilities are used to extract the last argument,
  200. as if the &lsquo;<samp>!$</samp>&rsquo; history expansion had been specified.
  201. </p>
  202. </dd>
  203. </dl>
  204. <hr>
  205. <div class="header">
  206. <p>
  207. Next: <a href="Commands-For-Text.html#Commands-For-Text" accesskey="n" rel="next">Commands For Text</a>, Previous: <a href="Commands-For-Moving.html#Commands-For-Moving" accesskey="p" rel="prev">Commands For Moving</a>, Up: <a href="Bindable-Readline-Commands.html#Bindable-Readline-Commands" accesskey="u" rel="up">Bindable Readline Commands</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>
  208. </div>
  209. </body>
  210. </html>