# $EPIC: history_circleq,v 1.5 2001/06/26 23:03:39 jsb Exp $
Synopsis:
   set history_circleq [<on|off|toggle>]

Description:
   * When ON (default) -- History browsing acts as a "circle queue".  When you
     are at the oldest entry in the history, the BACKWARD_HISTORY keybinding 
     goes to the newest entry in the history.  When you are the newest entry
     in the history, the FORWARD_HISTORY keybinding goes to the oldest entry
     in the history.  It is not possible to cancel history browsing without
     using the SEND_LINE key binding which adds a new entry to the history.
   * When OFF -- History browsing acts as a "list".  When you are at the
     oldest entry in the history, the BACKWARD_HISTORY keybinding has no
     effect.  When you are at the newest entry in the history, the 
     FORWARD_HISTORY keybinding has no effect.  Furthermore, the ERASE_LINE
     key binding cancels history browsing in addition to clearing the input
     line, without adding a new entry to the history.

Practical:
   The "ON" behavior is the traditional ircII behavior, which can be 
   rather disconcerting if you're not used to it.  The "OFF" behavior is
   more like how shells behave, and is probably more familiar to normal
   users.

See Also:
   bind(4) backward_history, forward_history, erase_line;
   history(4); set(4) history

