7 Jun 1995                                                      RCSLINK(1)



   NAME
     rcslink - create links between parallel directory hierarchies

   SYNOPSIS
     cd workdir
     rcslink [-n] _d_e_s_t_i_n_a_t_i_o_n _l_i_n_k_n_a_m_e

   DESCRIPTION
     _r_c_s_l_i_n_k 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 actu-
     ally exist. _r_c_s_l_i_n_k will destroy any symbolic links that already exist
     by the name _l_i_n_k_n_a_m_e in order to create what it wants, unless the link
     already points to the right place, in which case it will do nothing.

   EXAMPLES

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

     A link /mit/bar/src/RCS -> ../rcs will be created. If src has a sub-
     directory _f_o_o, 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 _f_o_o, then a link /mit/bar/src/foo/RCS -> /mit/bar/rcs/foo
     will be created. And so on...

   OPTIONS

     -n      This option causes _r_e_l_i_n_k 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 exe-
             cuted in a shell to get the same result.

   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.

   SEE ALSO
     ln(1), syncdir(1)

   AUTHOR
     Craig Fields, MIT Information Systems
     Copyright (c) 1995, Massachusetts Institute of Technology



   MIT Athena                                                               1


99