OUV_EXP(1)                       RPN UTILITY                        OUV_EXP(1)
NAME
      ouv_exp - open an experiment managed by etagere.

USAGE
       ouv_exp [name] [-RCSPATH [path ...] ]

DESCRIPTION
        ouv_exp is  a command of the etagere system (environnement de  travail
automatise de  gestion d'experiences  avec RCS)  used to  open an  experiment.
When it is used for the first time in a given directory, ouv_exp will create a
RCS sub-directory an ask you to supply   a value for the environment  variable
RCSPATH.   It will  then open  an experiment  called base.   The  name of  the
current experiment and the value of RCSPATH are stored in the .exper_cour file
in the local directory.

        When the  local  directory  has  already  been  used  in  the  etagere
environment, the user  is required  to supply the  name of  the experiment  to
open.  The name supplied must be the name of an already existing experiment in
the RCS sub-directory otherwise an error will occur (an experiment is  created
in the RCS sub-directory  whenever a frm_exp command  is issued). Whenever  an
experiment is reopened, ouv_exp extracts the .exper_cour file associated  with
this experiment and thus recreates the  etagere environment that was valid  at
the time the experiment was closed.

        ARGUMENT

        name  - name of the  experiment to open  and which will  serve as  the
                starting point  for the  work to  be done  during the  current
                experiment.  By default, name  is equal to base which  implies
                that the files obtained via omd_exp or clt_exp will always  be
                extracted from one of the RCS master directories specified  by
                the RCSPATH environment variable. If no name is given, ouv_exp
                will prompt the user to supply  the name of the experiment  to
                open.

        RCSPATH-path to the various RCS master directories.

        DEFINITION OF THE ETAGERE ENVIRONMENT VARIABLES

        RCSPATH-is a variable containing the  paths to the various RCS  master
                directories to search when looking for source files. The value
                of RCSPATH is kept in the .exper_cour file.

                The user may invoke setenv  to initialize RCSPATH or supply  a
                value through ouv_exp or mrcs_exp.

                RCSPATH has the following format:

                path1:rev1 path2:rev2 path3:rev3 ...

                where rev is the rcs revision number to use when extracting  a
                file from a RCS  master directory.  Rev  may be an integer  or
                real value.  If rev is real, the revision number obtained will
                match exactly -provided  that it exists-  the revision  number
                given in RCSPATH.  If  the revision number specified does  not
                exists, the  previous revision  to the  number given  will  be
                retrieved. If  rev  is an  integer  value,   the  most  recent
                version corresponding  to the  revision number  given will  be
                extracted.

                For example:

                setenv RCSPATH '/users/dor/armn/jfc/RCS1:2 \
                                /users/dor/armn/jfc/RCS2:3.4'

                implies that  the  user  wants  the  most  recent  version  of
                revision  number  2  for  the  files  contained  in  the  RCS1
                directory.  That is  to say that if  a file aaa.ftn exists  at
                revision levels 2.1 and 2.2, the revision extracted will be at
                level 2.2.

                On the other hand, the files from directory RCS2 will only  be
                extracted if they  exist at revision  level 3.4 or  lower.   A
                file bbb.ftn  with  revision  numbers  3.1  and  3.5  will  be
                retrieved at revision level 3.1.

                The revision number portion  is optional in  a RCSPATH. If  no
                revision number is specified, the most recent revision on  the
                trunk of the RCS  tree will be retrieved.  The following is  a
                valid RCSPATH:

                       '/users/dor/armn/jfc/RCS1 /users/dor/armn/jfc/RCS2'

        RCSBASE-contains the name  of the experiment  (revision in the  user's
                RCS subdirectory) that  is used  as a starting  point for  the
                current experiment.  If RCSBASE has for value "base", all  the
                files obtained via omd_exp, omdr_exp, clt_exp or cltr_exp will
                come from one of the RCS master directories given by  RCSPATH.
                The value for RCSBASE is also kept in the file .exper_cour  in
                the user's working directory.

EXAMPLES
        Opening an experiment for the first time in an empty directory:

        ouv_exp

        will create a RCS  sub-directory in the  user's working directory  and
will initialize the variables RCSPATH and RCSBASE.  RCSPATH will be set to the
value supplied  by the  user when  prompted by  ouv_exp.   If the  environment
variable RCSPATH has been previously set by a call to setenv, that value  will
be used.

        RCSBASE in this example will  have a value of  "base" since it is  the
first time that ouv_exp is used in this working directory.

        The user may now obtain files  through omd_exp, modify them, create  a
description file for  make (Makefile)  via make_exp and  compile his  modified
modules. He may  then save his  modifications by calling  frm_exp in order  to
create a new revision (i.e., an experiment)  in the working RCS sub-directory.
This new revision  will be  identified by  a name  supplied by  the user  upon
closing the experiment.

        If for instance, the user has named his experiment exper01, a call  to
ouv_exp with the following format:
        ouv_exp exper01

        will  open  the  experiment  exper01  and  re-initialize  the  working
environment -RCSPATH and RCSBASE- to the appropriate values.

AUTHOR
        James Caveen - RPN - november 1991
        Latest revision: March 1993

FILES
        RCS/histoire,v  - contains the history of all the experiments
                          saved in the RCS sub-directory.
        .exper_cour     - contains the values of the environment
                          variables RCSPATH and RCSBASE for the
                          current experiment.

NOTES

        Only one  experiment  may be  active  in a  given  working  directory.
Trying to  open  an  experiment in  a  directory  where there  is  already  an
experiment open will result in an error.

       The use of a  setenv RCSPATH will interfere when  trying to open a  new
experiment  that requires  a different RCSPATH than  the one specified by  the
environment.  In such a situation, the new value for RCSPATH must be  supplied
as an argument to ouv_exp;

                     ouv_exp -RCSPATH [path1 ... ]

Omission of the "path1 ..." portion will force full-screen mode.

NOTE
        See also clt_exp(1), cltr_exp(1), dir_exp(1), eff_exp(1),  etagere(1),
frm_exp(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),  qui_exp(1),  rev_exp(1),
smod_exp(1) and sor_exp(1).