История

Команда history выполняет одно из нескольких операций, связанных с недавно выполненными командами, записанными в списке истории. Каждая из этих записанных команд называется «событием». При указании события команде history можно использовать следующие формы:

Число: если положительное, оно относится к событию с этим номером (все события пронумерованы, начиная с 1). Если число отрицательное, оно выбирает событие относительно текущего события (-1 относится к предыдущему событию, -2 — к предыдущему и т.д.). Событие 0 относится к текущему событию.
Строка: выбирает последнее событие, которое соответствует строке. Событие считается соответствующим строке, если строка совпадает с первыми символами события или если строка соответствует событию в смысле команды string match.

Команда history может иметь любой из следующих видов:

history: То же самое, что history info, описано ниже.
history add команда ?exec?: Добавляет команду в список истории в качестве нового события. Если указано exec (или его сокращение), команда также выполняется, а ее результат возвращается. Если exec не указано, в качестве результата возвращается пустая строка.
history change новое значение ?событие?: Заменяет значение, записанное для события, на новое значение. Событие указывает событие для замены и по умолчанию равно текущему событию (а не событию -1). Эта команда предназначена для использования в командах, которые реализуют новые формы подстановки истории и хотят заменить текущее событие (которое вызывает подстановку) командой, созданной посредством подстановки. Возвращаемое значение — пустая строка.
history clear: Очистить список истории. Текущий лимит сохранения сохраняется. Номера событий истории сбрасываются.
history event ?событие?: Возвращает значение события, заданного событием. Событие по умолчанию равно -1.
history info ?количество?: Возвращает отформатированную строку (предназначенную для чтения человеком), содержащую номер события и содержимое каждого из событий в списке истории, кроме текущего события. Если указано количество, то возвращаются только самые последние количество событий.
history keep ?количество?: Эта команда может использоваться для изменения размера списка истории на количество событий. Изначально в списке истории сохраняется 20 событий. Если количество не указано, возвращается текущий предел сохранения.
history nextid: Возвращает номер следующего события, которое будет записано в список истории. Это полезно для таких вещей, как вывод номера события в командных строках.
history redo ?событие?: Повторно выполняет команду, указанную событием, и возвращает ее результат. Событие по умолчанию равно -1. Эта команда приводит к пересмотру истории: см. подробности ниже.

Ревизия истории

В Tcl версии до 8.0 существовала сложная система ревизии истории. Текущая система более ограничена, и старые операции истории substitute и words были удалены. (В качестве утешения была добавлена операция clear.)

Опция redo в команде history приводит к значительно более простой «ревизии истории». При вызове этой опции последнее событие изменяется для исключения команды истории и замены ее результатом команды истории. Если вы хотите повторить событие без изменения истории, используйте операцию event для извлечения некоторого события и операцию add для добавления его в историю и его выполнения.

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TclCmd/history.htm