3
<!-- Created by texi2html 1.56k from ess.texi on 6 August 2002 -->
5
<TITLE>ESS -- Emacs Speaks Statistics - Manipulating saved transcript files</TITLE>
8
Go to the <A HREF="ess_1.html">first</A>, <A HREF="ess_8.html">previous</A>, <A HREF="ess_10.html">next</A>, <A HREF="ess_16.html">last</A> section, <A HREF="ess_toc.html">table of contents</A>.
12
<H1><A NAME="SEC59" HREF="ess_toc.html#TOC59">Manipulating saved transcript files</A></H1>
15
Inferior <B>S</B> mode records the transcript (the list of all commands
16
executed, and their output) in the process buffer, which can be saved as
17
a <EM>transcript file</EM>, which should normally have the suffix
18
<TT>`.St'</TT>. The most obvious use for a transcript file is as a static
19
record of the actions you have performed in a particular <B>S</B> session.
20
Sometimes, however, you may wish to re-execute commands recorded in the
21
transcript file by submitting them to a running <B>ESS</B> process. This
22
is what Transcript Mode is for.
26
If you load file a with the suffix <TT>`.St'</TT> into Emacs, it is placed
27
in S Transcript Mode. Transcript Mode is similar to Inferior <B>S</B> mode
28
(see section <A HREF="ess_6.html#SEC35">Interacting with the <B>ESS</B> process</A>):
31
paragraphs are defined as a command and its output, and you can move
32
though commands either with the paragraph commands or with <KBD>C-c C-p</KBD>
33
and <KBD>C-c C-n</KBD>.
38
<LI><A HREF="ess_9.html#SEC60">Resubmit</A>: Resubmitting commands from the transcript file
39
<LI><A HREF="ess_9.html#SEC61">Clean</A>: Cleaning transcript files
44
<H2><A NAME="SEC60" HREF="ess_toc.html#TOC60">Resubmitting commands from the transcript file</A></H2>
47
Three commands are provided to re-submit command lines from the
48
transcript file to a running <B>ESS</B> process. They are:
55
<KBD>RET</KBD> (<CODE>ess-transcript-send-command</CODE>) <BR>
56
Send the current command line to the <B>ESS</B> process, and execute it.
61
<KBD>C-c RET</KBD> (<CODE>ess-transcript-copy-command</CODE>) <BR>
62
Copy the current command to the <B>ESS</B> process, and switch to the
63
<B>ESS</B> process buffer (ready to edit the copied command).
68
<KBD>M-RET</KBD> (<CODE>ess-transcript-send-command-and-move</CODE>) <BR>
69
Send the current command to the <B>ESS</B> process, and move to the next
70
command line. This command is useful for submitting a series of
75
Note that these commands are similar to those on the same keys in
76
Inferior <B>S</B> Mode. In all three cases, the commands should be
77
executed when the cursor is on a command line in the transcript; the
78
prompt is automatically removed before the command is submitted.
83
<H2><A NAME="SEC61" HREF="ess_toc.html#TOC61">Cleaning transcript files</A></H2>
86
Yet another use for transcript files is to extract the command lines for
87
inclusion in an <B>S</B> source file or function. Transcript mode provides
88
one command which does just this:
95
<KBD>C-c C-w</KBD> (<CODE>ess-transcript-clean-region</CODE>) <BR>
96
Deletes all prompts and command output in the region, leaving only the
101
The remaining command lines may then be copied to a source file or edit
102
buffer for inclusion in a function definition, or may be evaluated
103
directly (see section <A HREF="ess_7.html#SEC53">Sending code to the <B>ESS</B> process</A>) using the code evaluation commands
104
from <B>S</B> mode, also available in <B>S</B> Transcript Mode.
108
Go to the <A HREF="ess_1.html">first</A>, <A HREF="ess_8.html">previous</A>, <A HREF="ess_10.html">next</A>, <A HREF="ess_16.html">last</A> section, <A HREF="ess_toc.html">table of contents</A>.