diff options
Diffstat (limited to 'doc/history.0')
-rw-r--r-- | doc/history.0 | 63 |
1 files changed, 34 insertions, 29 deletions
diff --git a/doc/history.0 b/doc/history.0 index 2923769..50d6d37 100644 --- a/doc/history.0 +++ b/doc/history.0 @@ -6,7 +6,7 @@ NNAAMMEE history - GNU History Library CCOOPPYYRRIIGGHHTT - The GNU History Library is Copyright (C) 1989-2002 by the Free Software + The GNU History Library is Copyright (C) 1989-2011 by the Free Software Foundation, Inc. DDEESSCCRRIIPPTTIIOONN @@ -42,19 +42,21 @@ HHIISSTTOORRYY EEXXPPAANNSSIIOONN EEvveenntt DDeessiiggnnaattoorrss An event designator is a reference to a command line entry in the his- - tory list. + tory list. Unless the reference is absolute, events are relative to + the current position in the history list. - !! Start a history substitution, except when followed by a bbllaannkk, + !! Start a history substitution, except when followed by a bbllaannkk, newline, = or (. !!_n Refer to command line _n. - !!--_n Refer to the current command line minus _n. + !!--_n Refer to the current command minus _n. !!!! Refer to the previous command. This is a synonym for `!-1'. !!_s_t_r_i_n_g - Refer to the most recent command starting with _s_t_r_i_n_g. + Refer to the most recent command preceding the current position + in the history list starting with _s_t_r_i_n_g. !!??_s_t_r_i_n_g[[??]] - Refer to the most recent command containing _s_t_r_i_n_g. The trail- - ing ?? may be omitted if _s_t_r_i_n_g is followed immediately by a new- - line. + Refer to the most recent command preceding the current postition + in the history list containing _s_t_r_i_n_g. The trailing ?? may be + omitted if _s_t_r_i_n_g is followed immediately by a newline. ^^_s_t_r_i_n_g_1^^_s_t_r_i_n_g_2^^ Quick substitution. Repeat the last command, replacing _s_t_r_i_n_g_1 with _s_t_r_i_n_g_2. Equivalent to ``!!:s/_s_t_r_i_n_g_1/_s_t_r_i_n_g_2/'' (see MMoodd-- @@ -406,10 +408,13 @@ HHiissttoorryy FFuunnccttiioonnss The maximum number of history entries. This must be changed using ssttii-- ffllee__hhiissttoorryy(()). - _i_n_t hhiissttoorryy__wwrriittee__ttiimmeessttaammppss + _i_n_t hhiissttoorryy__wwiittee__ttiimmeessttaammppss If non-zero, timestamps are written to the history file, so they can be preserved between sessions. The default value is 0, meaning that time- - stamps are not saved. + stamps are not saved. The current timestamp format uses the value of + _h_i_s_t_o_r_y___c_o_m_m_e_n_t___c_h_a_r to delimit timestamp entries in the history file. + If that variable does not have a value (the default), timestamps will + not be written. _c_h_a_r hhiissttoorryy__eexxppaannssiioonn__cchhaarr The character that introduces a history event. The default is !!. Set- @@ -420,9 +425,9 @@ HHiissttoorryy FFuunnccttiioonnss line. The default is ^^. _c_h_a_r hhiissttoorryy__ccoommmmeenntt__cchhaarr - During tokenization, if this character is seen as the first character - of a word, then it and all subsequent characters up to a newline are - ignored, suppressing history expansion for the remainder of the line. + During tokenization, if this character is seen as the first character + of a word, then it and all subsequent characters up to a newline are + ignored, suppressing history expansion for the remainder of the line. This is disabled by default. _c_h_a_r _* hhiissttoorryy__wwoorrdd__ddeelliimmiitteerrss @@ -431,12 +436,12 @@ HHiissttoorryy FFuunnccttiioonnss _c_h_a_r _* hhiissttoorryy__nnoo__eexxppaanndd__cchhaarrss The list of characters which inhibit history expansion if found immedi- - ately following hhiissttoorryy__eexxppaannssiioonn__cchhaarr. The default is space, tab, + ately following hhiissttoorryy__eexxppaannssiioonn__cchhaarr. The default is space, tab, newline, \\rr, and ==. _c_h_a_r _* hhiissttoorryy__sseeaarrcchh__ddeelliimmiitteerr__cchhaarrss - The list of additional characters which can delimit a history search - string, in addition to space, tab, _: and _? in the case of a substring + The list of additional characters which can delimit a history search + string, in addition to space, tab, _: and _? in the case of a substring search. The default is empty. _i_n_t hhiissttoorryy__qquuootteess__iinnhhiibbiitt__eexxppaannssiioonn @@ -444,12 +449,12 @@ HHiissttoorryy FFuunnccttiioonnss sion character. The default value is 0. _r_l___l_i_n_e_b_u_f___f_u_n_c___t _* hhiissttoorryy__iinnhhiibbiitt__eexxppaannssiioonn__ffuunnccttiioonn - This should be set to the address of a function that takes two argu- - ments: a cchhaarr ** (_s_t_r_i_n_g) and an iinntt index into that string (_i). It - should return a non-zero value if the history expansion starting at - _s_t_r_i_n_g_[_i_] should not be performed; zero if the expansion should be - done. It is intended for use by applications like bbaasshh that use the - history expansion character for additional purposes. By default, this + This should be set to the address of a function that takes two argu- + ments: a cchhaarr ** (_s_t_r_i_n_g) and an iinntt index into that string (_i). It + should return a non-zero value if the history expansion starting at + _s_t_r_i_n_g_[_i_] should not be performed; zero if the expansion should be + done. It is intended for use by applications like bbaasshh that use the + history expansion character for additional purposes. By default, this variable is set to NNUULLLL. FFIILLEESS @@ -470,14 +475,14 @@ AAUUTTHHOORRSS chet@ins.CWRU.Edu BBUUGG RREEPPOORRTTSS - If you find a bug in the hhiissttoorryy library, you should report it. But - first, you should make sure that it really is a bug, and that it + If you find a bug in the hhiissttoorryy library, you should report it. But + first, you should make sure that it really is a bug, and that it appears in the latest version of the hhiissttoorryy library that you have. - Once you have determined that a bug actually exists, mail a bug report - to _b_u_g_-_r_e_a_d_l_i_n_e@_g_n_u_._o_r_g. If you have a fix, you are welcome to mail - that as well! Suggestions and `philosophical' bug reports may be - mailed to _b_u_g_-_r_e_a_d_l_i_n_e@_g_n_u_._o_r_g or posted to the Usenet newsgroup + Once you have determined that a bug actually exists, mail a bug report + to _b_u_g_-_r_e_a_d_l_i_n_e@_g_n_u_._o_r_g. If you have a fix, you are welcome to mail + that as well! Suggestions and `philosophical' bug reports may be + mailed to _b_u_g_-_r_e_a_d_l_i_n_e@_g_n_u_._o_r_g or posted to the Usenet newsgroup ggnnuu..bbaasshh..bbuugg. Comments and bug reports concerning this manual page should be directed @@ -485,4 +490,4 @@ BBUUGG RREEPPOORRTTSS -GNU History 6.0 2003 July 31 HISTORY(3) +GNU History 6.2 2010 August 12 HISTORY(3) |