.TH RCSLINK 1 "7 Jun 1995"
.ds ]W MIT Athena
.SH NAME
rcslink \- create links between parallel directory hierarchies
.SH SYNOPSIS
.nf
cd workdir
rcslink [-n] \fIdestination\fR \fIlinkname\fR
.fi
.SH DESCRIPTION
\fIrcslink\fR creates a symbolic link in each directory of the
hierarchy starting at the current working directory, pointing to
the counterpart directory in a parallel hierarchy. The parallel
hierarchy need not actually exist. \fIrcslink\fR will destroy
any symbolic links that already exist by the name \fIlinkname\fR
in order to create what it wants, unless the link already points
to the right place, in which case it will do nothing.
.SH EXAMPLES

     cd /mit/bar/src
     rcslink ../rcs RCS

A link /mit/bar/src/RCS -> ../rcs will be created. If src has a
subdirectory \fIfoo\fR, then a link /mit/bar/src/foo/RCS -> ../../rcs/foo
will be created. And so on...

     cd /mit/bar/src
     rcslink /mit/bar/rcs RCS

A link /mit/bar/src/RCS -> /mit/bar/rcs will be created. If src has a
subdirectory \fIfoo\fR, then a link /mit/bar/src/foo/RCS -> /mit/bar/rcs/foo
will be created. And so on...
.SH OPTIONS
.TP 8
.B \-n
This option causes \fIrelink\fR to only show what it would do, rather
than actually doing it. It displays this output in the form of shell
commands. Theoretically, this output could be piped through grep
to eliminate the "Processing" lines and then executed in a shell
to get the same result.
.SH BUGS
While the -n option produces output in the form of shell commands,
it is not actually clever about it; it does not escape characters
that the shell will interpret, so attempting to use this output to
do the work of creating the symbolic links may fail when there are
special characters in the links or filenames.
.SH SEE ALSO
ln(1), syncdir(1)
.SH AUTHOR
Craig Fields, MIT Information Systems
.br
Copyright (c) 1995, Massachusetts Institute of Technology