Octo uses the readline library to provide editing history and searching. This document provides a few pointers on how to use readline with Octo, but the user is best served by reading the readline documentation for finer points.
Octo reads history when started; and saves it when shutting down. The history file is by default in
~/.octo_history, but can be overridden to a different location by using the Octo Configuration file
octo_historysetting. The reference config file in
$ydb_dist/plugin/octo/octo.confstores the history in
~/.octo_history, which is the same as the default if a config file does not exist.
History length by default is 500. It can be overridden using the
octo_history_max_lengthsetting in the Octo Configuration file. The reference config file in
$ydb_dist/plugin/octo/octo.confsets this to 500, which is the same as the default if a config file does not exist.
This history length applies only when octo saves the history back to the file at process exit time; irrespective of this length, Octo will still read as much history as available in the history file pointed to by the
octo_historyconfig setting. And also irrespective of this length, while Octo is running, there is no history trimming being performed, so you can have more history while running Octo than the limit specified here.
When saving is done at exit time, history will be trimmed to
If you set
octo_history_max_lengthto zero, it disables saving history. If you set
octo_history_max_lengthto less than zero, it will be clamped down to zero.
Usual History Operations¶
The the usual operations to perform with history are as follows:
down arrowto navigate up and down your history list.
CTRL-Rshortcut to reverse search history.
\s<enter>to view your history.