FRM_EXP(1) RPN UTILITY FRM_EXP(1)
NAME
frm_exp - close an etagere experiment.
USAGE
frm_exp
DESCRIPTION
frm_exp is a command of the etagere system (environnement de travail
automatise de gestion d'experiences avec RCS) used to close the current
experiment. All the files with .ftn, .ptn, .cdk, .f (not generated from a
.ptn or .ftn file), .c, .s, .h and .txt extensions that were modified during
the current experiment will be saved and deposited as a new revision in the
experiment tree of the RCS sub-directory. The etagere environment variables
RCSPATH and RCSBASE are also saved as a new revision in the file
RCS/.exper_cour,v.
When closing an experiment, the user is asked to supply the name under
which the experiment will be known in the rcs revision tree. Giving a name
already in use will result in an error message. The hst_exp utility may be
used to obtain the list of all the experiment names present in the RCS
directory.
After having supplied a name for the experiment, the user is asked to
give a log message describing what the experiment being saved is about. The
message may be entered on the keyboard on one or more lines and is terminated
by the sequence CTL-D at the beginning of a new line. The log message may
also be kept in a separate file which will be read by frm_exp. If this is the
case, at the frm_exp prompt the user must redirect standard input to the log
file (< log_file) and terminate with the CTL-D sequence on a new line.
For instance, closing an experiment with the log message in the file
my_log_file:
Give a revision message (end with single CTL-D on a line)
< my_log_file
^D
AUTHOR
James Caveen - RPN - november 1991
Latest revision: November 1993
NOTES
An experiment name must begin with a letter and can only be composed
of letters, digits and the underscore character.
The length of the log message is limited to 64K.
When an experiment is being closed, all the files to be saved are
first copied to directory RCS/.RCS and are then deleted when the closing is
complete.
See also clt_exp(1), cltr_exp(1), dir_exp(1), eff_exp(1), etagere(1),
grep_exp(1), hst_exp(1), intro_exp(1), make_exp(1), mdm_exp(1), menu_exp(1),
mrcs_exp(1), omd_exp(1), omdr_exp(1), ouv_exp(1), qui_exp(1), rev_exp(1),
smod_exp(1) and sor_exp(1).