vci, the QEF version control system interface provides a number of mechanisms to invoke facilities of the underlying version system, be if rcs, cvs, SCCS, Perforce and so on. Some of these facilities are illustrated in the following.

% vci tell  # get list of locked files
/p/cook/s3.4/ctoe/etoc.l

% sls -a etoc.l  # list all etoc.l in path
/g/dt/cook/work/ctoe/etoc.l
/p/cook/s3.4/ctoe/etoc.l

% vci diff etoc.l  # show changes to file
=============================================================
RCS file: /p/cook/s3.4/ctoe/RCS/etoc.l,v
retrieving revision 1.1
diff -r1.1 etoc.l
84a85,88
> void{ENDL}    {
>               coutput("void");
>               castreset();
>       }
86c90
<               coutput ("int");
---
>               coutput("int");
88d91
<               /* gratuitous comment */

% vci vdiff etoc.l  # show changes to file visually

Given that the changes seem to be valid, we now use vci to check in the changes and then use qef to rebuild using the newly checked-in version.

% vci ci etoc.l  # check in the file
Checking in /g/dt/cook/work/ctoe/etoc.l
/p/cook/s3.4/ctoe/RCS/etoc.l,v  <--  etoc.l
new revision: 1.2; previous revision: 1.1
enter log message, terminated with single '.' or end of file:
>> added void type
>> .
done
Updating baseline /g/dt/cook/work/ctoe/etoc.l
/p/cook/s3.4/ctoe/RCS/etoc.l,v  -->  etoc.l
revision 1.2
done
cush: Enter to continue:^J

% qef etoc  # rebuild after check-in
#{ etoc @gobo 2003/07/18 04:48:15
# QEFHALTFILE: /g/dt/cook/obj/ctoe/%qef11225b.hlt
Moved:   /g/dt/cook/work/ctoe/etoc.l -> /p/cook/s3.4/ctoe/etoc.l
+ qlex /p/cook/s3.4/ctoe/etoc.l
+ cc -c -I. -I/g/dt/cook/work/ctoe -I/p/cook/s3.4/ctoe \
        -I/p/qtree/9.1/linux2_0i/include etoc.c
+ cc -o etoc etoc.o -L/p/qtree/9.1/linux2_0i/lib -ldt \
        /p/qtree/9.1/linux2_0i/lib/libl.a
#} E0 gobo@/g/dt/cook/obj/ctoe 2003/07/18 04:48:20(5)

% qef -Ptargets  # list qef targets possible
Local:          do local constructions
Install:        do installations
RemoveInst:     remove objects installed into other directories
RemoveObjs:     remove objects in local directories
RemoveAll:      remove installed and local objects
                Any of above can be followed by `List' which
                suppresses removals and leaves list in place.
Man:            install manual sections
Objects:        produce all *.o files
<module>.o:     produce object file for module
<module>.i:     produce preprocessed C code for module.[cly]
Sfiles:         produce *.s files
<module>.s:     produce assembly code for module.[cly]
<module>.c:     intermediate product for <module>.?
<module>~I:     do Install actions for installed file called 
	module
<module>~M:     do Man actions for installed file called module
<man>.<sect>~M: install manual section <man>.<sect>

Individual selectable items:

ctoe     ctoe.1~M ctoe~I   etoc     etoc.1~M etoc~I

% qef etoc~I etoc.1~M  # install etoc and its man section
#{ etoc~I etoc.1~M @gobo 2003/07/18 05:00:24
# QEFHALTFILE: /g/dt/cook/obj/ctoe/%qef11313b.hlt
+ instal -E -d /g/dt/cook/dest/bin/etoc etoc
+ instal -d /g/dt/cook/dest/man/man1/etoc.1 
	/p/cook/s3.4/ctoe/etoc.1
#} E0 gobo@/g/dt/cook/obj/ctoe 2003/07/18 05:00:24(0)

% incls etoc.l  # includes for `sls etoc.l`
/p/cook/s3.4/ctoe/etoc.l
    /p/qtree/9.1/linux2_0i/include/envir/system.h
    /p/qtree/9.1/linux2_0i/include/dtree/proginfo.h
    /p/qtree/9.1/linux2_0i/include/envir/types.h
        /usr/include/sys/types.h
            /usr/include/features.h
                /usr/include/sys/cdefs.h
                    /usr/include/features.h ... circular
                /usr/include/gnu/stubs.h
            /usr/include/gnu/types.h
                /usr/include/features.h ... listed above
            /usr/include/time.h
                /usr/include/features.h ... listed above
                /usr/lib/gcc-lib/i386-redhat-linux/2.7.2.3/
			include/stddef.h
                    machine/ansi.h ... missing
                /usr/include/timebits.h
                /usr/include/gnu/types.h ... listed above
# eliminated 77 additional lines

% incls -l etoc.l  # as above but a simple list
/p/cook/s3.4/ctoe/etoc.l
/p/qtree/9.1/linux2_0i/include/envir/system.h
/p/qtree/9.1/linux2_0i/include/dtree/proginfo.h
/p/qtree/9.1/linux2_0i/include/envir/types.h
/usr/include/sys/types.h
/usr/include/features.h
/usr/include/sys/cdefs.h
/usr/include/gnu/stubs.h
/usr/include/gnu/types.h
/usr/include/time.h
/usr/lib/gcc-lib/i386-redhat-linux/2.7.2.3/include/stddef.h
/usr/include/timebits.h
# eliminated 48 additional lines ...