133 lines
5.1 KiB
HTML
133 lines
5.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>history</title>
|
||
</head>
|
||
|
||
<body>
|
||
<h1>history</h1>
|
||
|
||
<p>Команда работает со списком выполнявшихся команд.</p>
|
||
|
||
<h2>СИНТАКСИС</h2>
|
||
|
||
<pre>
|
||
<strong>history</strong> ?<em>option</em>? ?<em>arg</em> <em>arg</em>
|
||
</pre>
|
||
|
||
<h2>ОПИСАНИЕ</h2>
|
||
|
||
<p> Команда <strong>history</strong> выполняет действия по отношению к
|
||
недавно выполненным командам, занесенным в журнал. Каждая из
|
||
этих зарегистрированных команд обозначается термином
|
||
"событие". Ссылаться на события в команде
|
||
<strong>history</strong> можно одним из следующих способов:</p>
|
||
<ol>
|
||
<li><em>Число</em>. Если положительное - ссылается на событие с
|
||
этим номером (все события нумеруются начиная с 1). Если число
|
||
отрицательное, то оно указывает номер события относительно
|
||
текущего (<strong>-1</strong> - предыдущее, <strong>-2</strong> - перед предыдущим
|
||
и т.д.). Событие <strong>0</strong> ссылается на текущее событие.</li>
|
||
|
||
<li><em>Строка</em>. Ссылается на наиболее позднее событие,
|
||
которое удовлетворяет строке. Событие удовлетворяет строке,
|
||
если оно начинается со строки, или в соответствии с правилами
|
||
команды <strong>string match</strong>.</li>
|
||
</ol>
|
||
|
||
<p>Команда <strong>history</strong> может принимать одну из следующих
|
||
форм.</p>
|
||
|
||
<dl>
|
||
<dt><strong>history</strong></dt>
|
||
|
||
<dd> То же самое, что команда <strong>history info</strong>, описанная
|
||
ниже. </dd>
|
||
|
||
<dt><strong>history</strong> <strong>add</strong> <em>command</em> ?<em>exec</em>? </dt>
|
||
|
||
<dd> Добавляет аргумент <em>command</em> в журнал как новое
|
||
событие. Если присутствует аргумент <strong><a href=
|
||
"exec.html">exec</a></strong>(или произвольное сокращение), то
|
||
команда <em>command</em> выполняется и возвращается ее
|
||
результат. В противном случае возвращается пустая строка.
|
||
</dd>
|
||
|
||
<dt><strong>history</strong> <strong>change</strong> <em>newValue</em>
|
||
?<em>event</em>?</dt>
|
||
|
||
<dd> Заменяет описание события <em>event</em> на <em>newValue</em>.
|
||
Аргумент <em>event</em> определяет событие, описание которого
|
||
будет заменено. По умолчанию - текущее событие (даже не
|
||
предыдущее!). Эта форма команды предназначается для
|
||
использования в тех случаях, когда переформировывается журнал
|
||
событий и позволяет заменить текущее событие (переформирование
|
||
журнала) на необходимое. Команда возвращает пустую строку.
|
||
</dd>
|
||
|
||
<dt> <strong>history</strong> <strong>clear</strong> </dt>
|
||
|
||
<dd> Удаляет журнал событий. Количество запоминаемых событий
|
||
(см. <strong>history</strong> <strong>keep</strong>) сохраняется. Нумерация
|
||
событий начинается сначала.
|
||
</dd>
|
||
|
||
<dt><strong>history</strong> <strong>event</strong> ?<em>event</em>?</dt>
|
||
|
||
<dd> Возвращает описания события <em>event</em>. Значение по
|
||
умолчанию <strong>-1.</strong>
|
||
</dd>
|
||
|
||
<dt> <strong>history</strong> <strong>info</strong> ?<em>count</em>? </dt>
|
||
|
||
<dd> Возвращает в удобном для чтения виде список, состоящий из
|
||
номеров и описаний событий (кроме текущего). Если аргумент
|
||
<em>count</em> задан, то только <em>count</em> последних событий
|
||
возвращаются.
|
||
</dd>
|
||
|
||
<dt> <strong>history</strong> <strong>keep</strong> ?<em>count</em>? </dt>
|
||
|
||
<dd> Команда изменяет размер журнала на <em>count</em> событий.
|
||
Исходно в журнале сохраняются 20 последних событий. Если
|
||
аргумент <em>count</em> не указан, команда возвращает текущее
|
||
значение размера журнала.
|
||
</dd>
|
||
|
||
<dt> <strong>history</strong> <strong>nextid</strong> </dt>
|
||
|
||
<dd> Возвращает номер следующего события, которое будет записано
|
||
в журнал. Полезно, например, для вывода номера события в
|
||
приглашении командной строки.
|
||
</dd>
|
||
|
||
<dt> <strong>history</strong> <strong>redo</strong> ?<em>event</em>? </dt>
|
||
|
||
<dd> Повторно выполняет команду, указанную с помощью аргумента
|
||
<em>event</em>. Значение аргумента по умолчанию <strong>-1</strong>. Эта
|
||
команда вызывает переформирование журнала, см. <a href=
|
||
"#ПЕРЕФОРМИРОВАНИЕ">ниже</a>.
|
||
<dd>
|
||
</dl>
|
||
|
||
<h2><a name="ПЕРЕФОРМИРОВАНИЕ"></a>ПЕРЕФОРМИРОВАНИЕ ЖУРНАЛА</h2>
|
||
|
||
<p> До версии 8.0 Tcl имел весьма сложный механизм
|
||
переформирования журнала. Новый механизм несколько сокращен за
|
||
счет старых опций <strong>substitute</strong> и <strong>words</strong>. (Взамен
|
||
добавлена новая опция <strong>clear</strong>).
|
||
|
||
<p>Опция <strong>redo</strong> позволяет переформировывать журнал
|
||
значительно проще. При ее выполнении последнее событие
|
||
изменяется таким образом, что удаляется "служебная"
|
||
команда <strong>history</strong>, которая реально выполнялась, а вместо
|
||
нее записывается та команда, которая необходима.</p>
|
||
|
||
<p>Если вы хотите повторить прежнюю команду, не модифицируя
|
||
журнал, выполните сначала команду <strong>history event</strong>, чтобы
|
||
извлечь описание команды, а затем <strong>history add</strong>, чтобы
|
||
выполнить ее.</p>
|
||
|
||
</body>
|
||
</html>
|